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CP/M-68K™™. Operating System Release Notes 
February 22, 1983 


S-RECORD SYSTEMS 
Either of the two S-record varsions of CP/M-68K included in this release 
may be comb ined with a user-su:plied BICS in order to obtain a working 
CP/M-68K operating system as discussed in the System Guide. In addition to 
the information given there, you need to know the size and entry points of 
the S-record systems. The two S-record system files are discussed separately 
in the following paragraphs. . = 
SR400.SYS resides in memory locations 400H toSDDFH. You should patch it 


> by placing the 32-bit address of your BIOS's init entry point at memory loca- 


tions 4F98H to 4F9BH. Your BIOS can Warm Boot by jumping to “FO9CH. -: 


—>  SR128K.SYS resides in memory locations 15000H to IA9FFH. You should patch 


it by placing the 32-bit address of your BIOS'S init entry point at memory. 
locations 19898H to 1989BH, Your BIOS can Warm Boot by jumping to 19B9CH. 


BUGS 

ft) The CPM.SYS file on disk 2 of the distribution system was intended to work 
with a floppy disk EXO0Rmacs ™ system. In fact, it does not. 
AS68 will not operate properly when the disk it is using is full. — 
If you have trouble with AS68, it is likely that you did not initialize 
it. See the Programmer's Guide for more information. . ee 

f°) DDT sets up an inccrrect command tail shen the program under test is. 
specified on the CCP command line invoking DDT rather than using the 
E and I commands in DOT. : 


CP/M-68K is a trademark of Digital Research. 
EXORmacs is a trademark of Motorola. 
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Foreword 


CP/M~68K™ is a single-user general purpose operating system. 
It is designed for use with any disk-based computer using a Motorola® 
MC68000 or compatible processor. CP/M-68K is modular in design, and 
can be modified to suit the needs of a Particular installation. 


The hardware interface for a particular hardware environment is 
supported by the OEM or CP/M-68K distributor. Digital Research 
Supports the user interface to CP/M-68K as documented in the CP/M— 
68K Operating System User's Guide. Digital Research does not 
support any additions or modifications made to CP/M-68K by the O&M 
or distributer. 


Purpose and Audience 


This manual is intended to provide the information needed by a 
Systems programmer in adapting CP/M-68K to a particular hardware 
environment. A substantial degree of programming expertise is 
assumed on the part of the reader, and it is not expected that 
typical users of CP/M-68K will need or want to read this manual. 


Prerequisites and Related Publications 


In addition to this manual, the reader should be familiar with 
the architecture of the Motorola MC68000. as described in the 
Motorola 16-Bit Micro sso ser's Ma (third edition), the 


‘CP/M-68K User's and Programmer's Guides, and, of course, the details 
of the hardware environment where CP/M-68K is to be implemented. 


How Phis Book is Organized 


Section 1 presents an overview of CP/M-68K and describes its 
major components. Section 2 discusses the adaptation of CP/M-68K 
for your specific hardware system. Section 3 discusses bootstrap 
procedures and related information. Section 4 describes each BIOS 
function including entry parameters and return values’. Section 5 
describes the process of creating a BIOS for a custom hacdware 
interface. Section 6 discusses how to get CP/M® working for the 
first time on a new hardware environment. Section 7: describes a 
procedure for causing a command to be automatically executed on cold 
boot. Section 8 describes the PUTBOOT utility, which is useful in 
generating a bootable disk. 


Appendix A describes the contents of the CP/M-68K distribution 
disks. Appendixes B, C, and D are listings of various BI0Ses. 
Appendix E contains a listing of the PUTBOOT utility program. 
Appendix F describes the Motorola S-record representation for 
programs. i 
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Section |! 
System Overview 


1.1 Introduction 


CP/M-68K is a single-user, general purpose operating system 
for microcomputers. based on the Motorola MC68000 or equivalent 
Microprocessor chip. It is designed to be adaptable to almost any 
hardware environment, and can be readily customized for particular 
hardware systems. 


CP/M-68K is equivalent to other CP/M systems with changes. 
dictated by the 68000 architecture. In particulac, CP/M-68K 
Supports the very large address space of the 68000 family. The 
CP/M-68K file system is upwardly compatible with CP/M-80™ version 
2.2 and CP/M-86® Version 1.1. The CP/M-68K file structure allows 
files of up to 32 megabytes per file. CP/M-68K supports .from one 
to sixteen disk drives with as many as 512 megabytes per drive. 


The entire CP/M-68K operating system resides in memory at all 
times, and is not reloaded at a warm start. CP/M-68K can be 
configured to reside in any portion of memory above the 68000 
exception vector area (0H to 3FFH). The remainder of the address 
space is available for applications BEcar anes and is called the 
transient ‘Program area, TPA. 


Several terns used throughout this manual are defined in 
Table l-1. 
Table l-l. CP/M~-68K Terus 


4-bit half-byte 
8-bit value 


16-bit value 


longword 32-bit value 


address 32-bit identifier of a storage 
location 


offset a value defining an address in 
storage; a fixed displacement from 
some other address 
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Table l-1. (continued) 


text segment program section containing machine ; 
instructions 


data segment program section containing 
initialized data 


block storage program section containing 
segment (bss) uninitialized data 


absolute describes a program which must reside 
at a fixed memory address. 


relocatable describes a program which includes 
relocation information so it can be 
loaded into memory at any address 


The CP/M-68K programming model is described in detail in the 
CP/M-68K Operating System Programmer's Guide. To summarize that 
“model briefiy, SELES supports four segments within a program: 
text, data, block storage segment (bss), and stack. When a program _ 
is loaded, CP/M-68K allocates space for all four segments in the “) 


TPA, and loads the text and data segments. A transient program may 
manage free memory using values stored by CP/M-68K in its base page. 
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USER 


User Interface 


(CCP) 


Programming 
Interface 


(BDOS) 


Hardware 
Interface 


(BIOS) 


HARDWARE ENVIRONMENT 
Pigure l-1. CP/M-68K Interfaces 


1.2 CP/M-68K Organization 


CP/M-68K comprises three system modules: the Console Command 
Processor (CCP) the Basic Disk Operating System (BDOS) and the Basic 
Input/Output System (BIOS). These modules are linked together to 
form the operating system. They are discussed individually in this. 
section. 


1.3 Memory Layout 


The CP/M-68K operating system can reside anywhere in memory 
except in the interrupt vector area (0H to 3FPH). The location of 
CP/M-68K is defined during system generation. Usually, the CP/M-68K 
Operating system is placed at the top end (high address) of 
available memory, and the TPA runs from 400H to the base of the 


All Infcemation Presented dere is Proprietary to Digital Research 


operating system. It is possible, however, to have other 
organizations for memory. For example, CP/M-68K could go in the low 
part of memory with the TPA above it. CP/M-68K could even be placed 
in the middle of available memory. 


However, because: the TPA must be one contiguous piece, part - 
of memory would be unavailable for transient programs in this case. > 
Usually this is wasteful, but such an organization might be useful 
if an area of memory is to be used for a bit-mapped graphics device, 
for example, or if there are ROM-resident routines. The BIOS and 


specialized application programs might know this memory exists, but 
it is not part of the TPA. 


ccP & BDOS & BIOS 


User Stack 


Interrupt Vectors 


Figure 1-2. Typical CP/M-68K Memory Layout 


Top of - 
Memory 


| 
CP/M 68K 


TPA -) 


000008 


1.4 Console Command Processor (CCP) 
The Console Command Processor, (CCP) provides the user 
interface to CP/M-68K. It uses the BDOS to read user commands and 


load programs, and provides several built-in user commands. It also 
provides parsing of command lines entered at the console. 
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1.5 Basic Disk Operating System (BDOS ) 


The Basic Disk Operating System (BDOS) provides operating 
System services to applications programs and to the CCP. These 
include character I/O, disk file I/O (the BDOS disk 1/O operations 

— comprise the CP/M-68K file system), program loading, and others. 


1.6 Basic I/O System (BIOS) 


The Basic Input Output System (BIOS) is the interface between 
CP/M-68K and its hardware environment. All physical input and 
Output is done by the BIOS. It includes all physical device 
drivers, tables defining disk characteristics, and other hardware 
specific functions and tables. The CCP and BDOS do not change for 
different hardware environments because all hardware dependencies 


have been concentrated in the BIOS. Each hardware configuration . 


needs its own BIOS. Section 4 describes the BIOS functions in 
detail. Section 5 discusses how to write a custom BIOS. Sample 
BIOSes are presented in the appendixes. : 


1.7 I/0 Devices 


CP/M~68K recognizes two basic types of I/0 devices: character 
devices and disk drives. Character devices are serial devices that 
handle one character at a time. Disk devices handle data in units 

aie of 128 bytes, called sectors, and provide a large number of sectors 
\ which can be accessed in random, nonsequential, order. In fact, 
real systems might have devices with characteristics different from 
these. Tt is the BIOS's responsibility to resolve differences 
between the logical device mdals and the actual physical devices. 


1.7.1 Charactar Devices 


Charactec devices are input output devices which accept or 
supply streams of ASCII characters to the computer. Typical 
character devices are consoles, printers, and modems. In CP/M-68K 
Operations on character devices are done one character at a time. A 
tre input device sends ASCII CTRL-Z (1AH) to indicate end-of- 

ile. 


1.7.2 Character Devices 


Disk devices are used for file storage. They are organized 
into sectors and tracks. Each sector contains 128 bytes of data. 


jo: (If sector sizes other than 128 bytes are used on the actual disk, 
Me then the BIOS must do a logical-to-physical Mapping to simulate 128- 
oer byte sectors to the rest of the system.) All disk I/O in CP/M-68K is 


-done in oOne-sector units. A track is a group of sectors. The 
number of sectors on a track is a constant depending on the 
particular device. (The characteristics of a disk device are 
specified in the Disk Parameter Block for that device. See 
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Section 5.) To locate a particular sector, the disk, track number, 
and sector number must all be specified. 


1.8 System Generation and Cold Start Operation 


Generating a CP/M-68K system is done by linking together the 
CCP, BDOS, and BIOS to create a file called CPM.SYS, which is the 
operating system. Section 2 discusses how to create CPM.SYS. 
CPM.SYS is brought into memory by a bootstrap loader which will 
typically reside on the first two tracks of a system disk. (The 
term system disk as used here simply means a disk with the file 
CPM.SYS and a bootstrap loader.) Creation of a bootstrap loader is 
discussed in Section 3. 


End of Section 1 
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Section 2 
System Generation 


2.1 Overview 


This section describes how to build a custom version of CP/M= 
68K by combining your BIOS with the CCP and BDOS supplied by Digital 
Research to obtain a CP/M-68K Operating system suitable for your 
specific hardware system. Section 5 describes how to create a BIOS. 


In this section, we assume that you have access to an already 
configured and executable CP/M-68K System. I£ you do not, you 
should first read Section 6, which discusses how you can make your 
first CP/M-68K system work. 


' A CP/M-68K operating system is generated by using the Linker, 
LO68, to link together the system modules (CCP, BDOS, and BIOS). 
Then the RELOC utility is used to bind the System to an absolute 
memory location. The resulting file is the configured operating 
system. It is named CPM.SYS. 


2.2 Creating CPM.SyYS: 


. The CCP and BDOS for CP/M-68K are distributed in a library 
file named CPMLIB. You must link your BIOS with CPMLIB using the 
following command: : 


A>LO68 -R -UCPM -O CPM.REL CPMLIB BIOS.O 


where BIOS.O is the compiled or assembled BIOS. This creates 
CPM.REL, which is a relocatable version of your system. The cold 
boot loader, however, can load only an absolute version of the 
System, so you must now create CPM.SYS, an absolute version of your 
System. If you want your system to reside at the top of memory, 
first find the size of the system with the following command: 


A>SIZE68 CPM.REL 


_ This gives you the total size of the system in both decimal 
and hex byte counts. Subtract this number from the highest memory 
address in your system and add one to get the highest possible 
address at which CPM.REL can be relocated. Assuming that the result 
is aaaaaa, type this command: : 


A>RELOC -Baaaaaa CPM.REL CPM.SYS 


The result is the CPM.SYS file, relocated to load at memory 
address aaaaaa. If you want CPM.SYS to reside at some other memory 
address, such as immediately above the exception vector area, you 
can use RELOC to place the system at that address. 
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When you perform the relocation, verify that the resulting 
system does not overlap the TPA as defined in the BIOS. The 
boundaries of the system are determined by taking the relocation 
address of CPM.SYS as the base, and adding the size of the system 
- (use SIZE68 on CPM.SYS) to get the upper bound. This address range 
must not overlap the TPA that the BIOS defines in the Memory Region > 
Table. 


2.3 Relocating Utilities 


Once you have built CPM.SYS, it is advisable to relocate the 
operating system utilities for your TPA using the RELOC utility. 
RELOC is described in the CP/M-68K erating System Programmer's 
Guide. This results in the utilities being absolute, tather than 
relocatable, but they will occupy half the disk space and load into 
memory twice as fast in their new form. You should also keep the 


relocatable versions backed up in case you ever need to use them in 
different TPA. 


End of Section 2 
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Section 3 
Bootstrap Procedures 


3.1 Bootstrapping Overview 


Bootstrap loading is the process of Bringing the CP/M-68K 
operating system into memory and passing control to it. Bootstrap 
loading is necessarily hardware dependent, and it is not possible to 
discuss all possible variations in this manual. However, the manual 
presents a model of bootstrapping that is applicable to most 
systems. 


The model of bootstrapping which we present assumes that the. 
CP/M-68K operating system is to be loaded into memory froma disk in 
which the first few tracks (typically the first two) are reserved 
: for the operating system and bootstrap routines, while the remainder 
i of the disk contains the file Structure, consisting of a directory 
and disk files. (The topic of disk organization and parameters is 
discussed in Section 5.) In our model, the CP/M-68K operating 
system resides in a disk file named CPM.SYS (described in Section 
2), and the system tracks contain a bootstrap loader program 
(CPMLDR.SYS) which knows how to read CPM.SYS into memory and 

transfer control to it. 


os Most systenis have a boot procedure similar to the following: 


1) When you press reset, or execute a boot command from a 
monitor ROM, the hardware loads one or more sectors 
beginning at track 0, sector 1, into memory at a 
predetermined address, and then jumps to that address. 


2) The code that came from track 0, sector 1, and is now 
executing, is typically a small bootstrap routine that 
loads the rest of the sectors on the system tracks 

: (containing CPMLDR) into another predetermined address in 

i memory, and then jumps to that address. Note that if your 

i hardware is smart enough, steps 1 and 2 can be combined 

into one step. : 


‘ 3) The code loaded in step 2, which is now executing, is the 
CP/M Cold Boot Loader, CPMLDR, which is an abbreviated 
version of CP/M-68K itself. CPMLDR now finds the file 
CPM.S¥S, loads it, and jumps to it. A copy Of CPM.SYS is 
now in memory, executing. This completes the bootstrapping 
ae process. 


In order to create a CP/M-68K diskette that can be booted, you 
need to know how to create CPM.SYS (see Section,2.2), how to create 
the Cold Boot Loader, CPMLDR, and how to put CPMLDR onto your system 
tracks. You must also understand your hardware enough to be able to 
: design a method for bringing CPMLDR into memory and executing it. 
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3.2 Creating the Cold Boot Loader 


CPMLDR is a miniature version of CP/M-68K. It contains 
stripped versions of the BDOS and BIOS, with only those functions 
which are needed to open the CPM.SYS file and: read it into memory. 
CPMLDR will exist in at least two forms; one form is the information 
in the system tracks, the other is a file named CPMLDR.SYS which is 
created by the linker. The term CPMLDR is used to refer to either 
of these forms, but CPMLDR.SYS only refers to the file. 


CPMLDR.SYS is generated using a procedure similar to that used 
in generating CPM.SYS. That is, a loader BIOS is linked with a 


loader system library, named LDRLIB, to produce CPMLDR.SYS.. 


Additional modules may be linked in as required by your hardware. 
The resulting file is then loaded onto the system tracks using a 
utility program named PUTBOOT. 


3.2.1 Writing a Loader BIOS 


The loader BIOS is very similar to your ordinary BIOS; it just 
has fewer functions, and the entry convention is slightly different. 
The differences are itemized below. 


1) Only one disk needs to be supported. The loader system 
selects only drive A. If you want to boot from a drive 
other than A, your loader BIOS should be written to select 
that other drive when it receives a request to select drive 


2) The loader BIOS is not called through a trap; the loader 


BDOS calls an entry point named _bios instead. The 
Parameters are still passed in registers, just as in the 
normal BIOS. Thus, your Function 0 does not need to 
initialize a trap, the code that in a normal BIOS would be 
the Trap 3 handler should have the label _bios, and you 
exit from your loader BIOS with an RTS instruction instead 
of an RTE. : 


3) Only the following BIOS functions need to be implemented: 
0 (Init) Called just once, should initialize hardware 
as necessary, no return value necessary. Note that 
Function 0 is called via bios with the function number 
equal to 0. You do not need a separate init entry point. 
4 (Conout) Used to print error messages during boot. [ff 
you do not want error messages, this function should just 
be an rts. 

9 (Seldsk) Called just once, to select drive ?.. 


10 (Settrk) 
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ll (Setsec) 
12 (Setdma) 
13 (Read) 


16 (Sectran) 


18 (Get MRT) Not used now, but may be used in future 
releases. 


22 (Set exception) 


4) You do not need to include an allocation vector or a check 
vector, and the Disk Parameter Header values that point to 
these can be anything. However, you still need a Disk 
Paramétec Header, Disk Parameter Block, and directory 
buffer. 


It is possible to use the same source code for both your normal 
BIOS and your loader BIOS if you use conditional compilation or 
assembly to distinguish the two. We have done this in our example 
BIOS for the EXORmacs-” 


3.2.2 Building CPMLDR.SYS 


Once you have written and compiled (or assembled) a loader 
BIOS, you can build CPMLDR.SYS in a manner very similar to building 
CPM.SY¥S. There is one additional complication here: the result of 
this step is placed on the system tracks. So, if you need a small 
prebooter to bring in the bulk of CPMLDR, the prebooter must also be 
included in the link you are about to do. The details of what must 
be done are hardware dependent, but the following example should 
help to clarify the concepts involved. 


Suppose that your hardware reads track 0, sector 1, into memory 
at location 400H when reset is pressed, then jump to 400H. Then 
your boot disk must have a small program in that sector that can 
load the rest of the system tracks into memory and execute ‘the code 
that they contain. Suppose that you have written such a program, 
assembled it, and the assembler output is in BOOT.O. Also assume 
that your loader BIOS object code is in the file LDRBIOS.O. Then 
the following command links together the code that must go on the 
system tracks. ~ 


A>1068. -s -T400 -uldr -o cpmldr.sys boot.o ldrlib ldrbios.o 


Once you have created CPMLDR.SYS in this way, you can use the 
PUTROOT utility to place it on the system tracks. PUTBOOT is 
described in Section 8. The command to Place CPMLDR on the system 
tracks of drive A is: 


A>putboot cpmldr.sys a 
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PUTBOOT reads the file CPMLDR.SYS, strips off the 28-byte 
command file header, and puts the result on the specified drive. 
You can now boot from this disk, assuming that CPM.SYS is on the 
disk. : 


End of Section 3 


? 


AiL Information Presented Here ig Proprietary to Digital Research 


12 


wen eno ee ee re ee re mee ee ee me ee tee 


OES Fan RCE BRR SEE TOPLESS ee a 


’ . 


Section 4 
BIOS Functions 


4.1 Introduction 


All CP/M-68K hardware dependencies are concentrated in 
subroutines that are collectively referred to as the Basic 1/0 
System (BIOS). A CP/M=-68K system implementor can tailor CP/M-68K to 
fit nearly any 68000 operating environment. This section describes 
each BIOS function: its calling conventions, parameters, and the 
actions it must perform. The discussion of Disk Definition Tables 
is treated separately in Section 5. 


When the BDOS calls a BIOS function, it places the function 
number in register DO.W, and function parameters in registers Dl and 
D2. It then executes a TRAP 3 instruction. DO.W is always needed 
to specify the function, but each function has its own requirements 
for other parameters, which are described in the section describing 
the particular function. The BIOS returns results, if any, in 
register DO. The size of the result depends on the particular 
function. 


Mote: the BIOS does not need to preserve the contents of registers. 
That is, any register contents which were valid on entry to the BIOS 
may be destroyed by the BIOS on exit. The BDOS does not depend on 
the BIOS to preserve the contents of data or address registers. Of 
course, if the BIOS uses interrupts to service I/O, the interrupt 
handlers will need to preserve registers. 


Usually, user applications do not need to make direct use of 
BIOS functions. However, when access to the BIOS is required by 
user software, it should use the 3D0S Direct BIOS Function, Call 50, 
instead of calling the BtOS with a TRAP 3 instruction. This rule 
ensures that applications remain compatible with future systems. 


: The Disk Parameter Header (DPH) and Disk Parameter Block (DPB) 
formats have changed slightly from previous CP/M versions to 
accommodate the 68000's 32-bit addresses. The formats are described 
in Section 5. 
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Entry Parameters: 


DO.W = function code : 
D1.x = first parameter i 
D2.x = Second parameter 


Return Values: 


DO.B = byte values (8 bits) : 
DO.W = word values (16 bits) 
DO.L = longword values (32 bits) 


The decimal BIOS function numbers and the functions they 
cortespond to are listed in Table 4-2. 


Table 42. BIOS Functions 


Initialization (called for cold boot) 
Warm Boot (called for warm start) 
Console Status (check foc console 
character ready) .. 
: Read Console Character In > 
bs Write Console Character Out ty 
; List (weite listing character out) 
Auxiliary Output (write character to 
auxiliary output device) 
Auxiliary Input (read from auxiliary 
input) . 
Home (move to track 00) 
Select Disk Drive 
Set Track Number 
Set Sector Number 
Set DMA Address 
Read Selected Sector 
Write Selected Sector 
Return List Status 
Sector Translate 
Get Memory Region Table Address 
Get I/O Mapping Byte 
Set I/O Mapping Byte 
Flush Buffers 
Set Exception Handler Address 


ALL Information Prasented 3ere is Proprietary to Digital Research . 


L4 


ITT ET ATR ARTEL TOTS A - LS SRS RS ee ES we += eee oe 


Oe e.g mom etme 


wes UUM wyoesm GULUuG FUuNCTLON Us Initialization 


: FUNCTION 0: INITIALIZATION 


Entry Parameters: 
Register DO.W: 00H 


Returned Value: 
Register DO.W: User/Disk Numbers 


This routine is entered on cold boot and must initialize the 
BIOS. Punction 0 is unique, in that it is not entered with a TRAP 3 
instruction. instead, the BIOS has a global label, _init, which is 
the entry to this routine. On cold boot, Function 0 is called by a 
jst _init. When initialization is done, exit is through an rts 
instruction. Function 0 is responsible for initializing hardware if 
necessary, initializing BIOS internal variables (such as IOBYTE) as 
needed, setting up register DO as described below, setting the Trap 
3 vector to point to the main BIOS entry point, and then exiting 
with an rts. 


Function 0 returns a longword value. The CCP uses this value 
to set the initial user number and the initial default disk drive. 
The least significant byte of DO is the disk number (0 for drive A, 
lL for drive B, and so on). The next most significant byte is the 
usec number. The high-order bytes should be zero. 


The entry point to this function must be named _init and must 
be declared global. This function is called only once from the 
System at system initialization. a : 


Following is an example of skeletal code: 


eglobl init sbios init entry point 

init: 

* do any initialization here 
move. 1 #traphnd1,$8c ;Sset trap 3 handler 
eclr.l ao zlogin drive A, user 0 
rts 
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CP/M-68K System Guide Function 1: Warm Boot 


FUNCTION 1: WARM BOOT 


Entry Parameters: 
Register DO.W: O18 


Returned Value: None 


This function is called whenever a Program terminates. Some 
reinitialization of the hardware or software might occur. When this 
function completes, it jumps directly to the entry point of the CCP, 
named ccp. Note that ~cCCP must be declared as a global. 


Following is an example of skeletal code for this BIOS 
function: 


-globl _cep 
wohoot: 
* do any reinitialization here if necessary 
jmp cep 
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FUNCTION 2: CONSOLE STATUS 


| Entry Parameters: 
Register DO.W: 028 
Returned Values 
Register DO.W: OOFPFH if ready 
Register DO.W: QQQ0H if not ready 
This function returns the status of the currently assigned 
console device. It returns OOFFH in register DO when a character is 
ready to be read, or 0000H in register DO when no console characters 
are ready. 
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Entry Parameters: , +) 


Register DO.W: 03H 


Returned Value: 
Register DQ.W: Character 


This function reads the next console character into register 
DO.W. If no console character is: ready, it waits until a character 
is typed before returning. 


4 
ao 
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Entry Parameters: 


Register DO.W: 04H 
Register D1.W: Character 


Returned Value: None 


This function sends the character from register Dl to the 
console output device. The character is in ASCII. You might want 
to include a delay or filler characters for a line<feed or carriage 
return, if your console device requires some time interval at the 
end of the line (such as a TI Silent 700 Terminal® ). You can 
also filter out control characters which have undesirable effects on 
the console device. 


oom, 
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FUNCTION 5: LIST CHARACTER OUTPUT 


Entry Parameters: B 


Register DO.W: 05H 
Register D1l.W: Character 


Returned Value: None 


This function sends an ASCII character from register Dl to the 
currently assigned listing device. If your list device requires 
some communication protocol, it must be handled here. 
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FUNCTION 6: AUXILIARY OUTPUT 


Entry Parameters: 
© Register DO.W: O68 
Register Dl.W: Character 


oo 


Returned Value: 


Register DO.W: Character 


This function sends an ASCII character from-register Dl to the 
currently assigned auxiliary output device. 
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FUNCTION 7: AUXILIARY INPUT 


Entry Parameters: 


Register DO.W: — 


Returned Value: 
Register DO.W: Character 


This function reads the next character from the currently 
assigned auxiliary input device into register DO. It reports an 
end-of-file condition by returning an ASCIT CTRL-Z (1AH). 
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CP/M-68K System Guide : Function 8: some 


FUNCTION 8: HOME 


Entry Parameters: 
Register DO.W: 08H 

: Returned Value: None 
This function returns the disk head of the currently selected 
: disk to the track 00 position. If your controller does not have a 
: special feature for finding track 00, you can translate the call to 
: a SETTRK function with a parameter of 0. 

ge 
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FUNCTION 9: SELECT DISK DRIVE 


Entry Parameters: 

Register DO.W: OSH 

Register D1.B: Disk Drive 
Register D2.B: Logged in Plag 


Returned Value: 
Register DO.L: Address of Selected 
Drive's DPH 


This function selects the disk drive specified in register Dl 
x further operations. Register Dl contains 0 for drive A, 1 for 
uzive B, up to 15 for drive P. 


On each disk select, this function returns the address of the 
selected drive's Disk Parameter Header in register DO.L. See 
Section 5 for a discussion of the Disk Parameter Header. 


If there is an attempt to select a nonexistent drive, this 
function returns 00000000H in register DO.L as an error indicator. 
Although the function must return the header address on each call, 
it may be advisable to postpone the actual physical disk select 
operation until an I/O function (seek, read, or write) is performed. 
Disk select operations can occur without a subsequent disk 
operation. Thus, doing a physical select each time this function is 
called may be wasteful of time. 


On entry to the Select Disk Drive function, if the least 
significant bit in register D2 is zero, the disk is not currently 
igged in. If the disk drive is capable of handling varying” media 

mich as single- and double-sided disks, single- and double-density, 
aid sQ on), the BIOS should check the type of media currently 
installed and set up the Disk Parameter Block accordingly at this 
time. . . : : 
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FUNCTION 10: SET TRACK NUMBER 


Entry Parameters: 
Register DO.W: OAH 
Register D1L.W: Disk track number 


Returned Value: None 


This function specifies in register DO.W the disk track number 
for use in subsequent disk accesses. The track number remains valid 
until either another Function 10 or a Function 8 (Home) is 
performed. 


You can choose to physically seek to the selected track at this 
time, or delay the physical seek until the next read or write 
actually cccurs. 


The track number can range from 0 to the maximum track number 
supported by the physical drive. However, the maximum track number 
is limited to 65535 by the fact that it is being passed as a lL6-bit 
quantity. Standard floppy disks have tracks numbered from 0 to 76. 
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FUNCTION 11: SET SECTOR NUMBER 


Entry Parameters: 
Register DO.W: OBH 
Register Dl.W:s Sector Number 


Returned Value: None 


This function specifies in register D1.W the sector number for 
subsequent disk accesses. This number remains in effect until 
either another Function 11 is performed. 


The function selects actual (unskewed) sector numbers. Tf 
sewing is appropriate, it will have previously been done by a call 
_> Punction 16. You can send this information to the controller at 


this point or delay sector selection until a read or write operation 
eccurs. 
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FUNCTION 12: SET DMA ADDRESS 


Entry Parameters: 
Register DO.W: OCH 
Register Dl.L: DMA Address 


Returned Value: None 


This function contains the DMA (disk memory access) address in 
register Dl for subsequent read or write Operations. Note that the 
controller need not actually support DMA (direct memory access). 
The BIOS will use the 128=-byte area Starting at the selected DMA 
address for the memory buffer during the following read or write 
operations. This function can be called with either an even or an 
odd address for a DMA buffer. : 
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FUNCTION 13: READ SECTOR 


Entry Parameters: 
Register DO.W: ODH 


Returned Value: 
Register DO.W: 0 if no error 
Register DO.W: 1 if physical error 


After the drive has been selected, the track has been set, the 
sector has been set, and the DMA address has been specified, the 
read function uses’ these parameters to read one sector and returns 
he error code in register DO. 


Currently, CP/M-68K responds only to a zero or nonzero return 
code value. Thus, if the value in register DO is zero, CP/M-68K 
assumes that the disk operation completed properly. If an error 
occurs however, the BIOS should attempt at least ten retries to see 
if the error is recoverable. 


— 
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FUNCTION 14: WRITE SECTOR 


Entry Parameters: 
Register DO.W: OEH 
Register Dl.W: O#normal write 

l=write to a directory 
sector 
2zwrite to first sector 
of new block 


Paar 


Returned Value: 
Register DO.W: Ono error 
l*physical error 


This function is used to write 128 bytes of data from the 
currently selected OMA buffer to the currently selected sector, 
track, and disk. The value in register DlL.W indicates whether the 
write is an ordjmary write operation or whether the there are 
special considerations. 


If register Dl.W=0, this is an ordinary write operation. TI£ 
pos Dl.W=l, this is a write to a directory sector, and the write should 
NO be physically completed immediately. If Dl.W#2, this is a write to 
the first sector of a newly allocated block of the disk. The 
significance of this value is discussed in Section 5 under Disk 
Buffering. 
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FUNCTION 15: RETURN LIST STATUS 


Entry Parameters: 
Register DO.W: OFH 


Returned Value: 
Register DO: OOFFH=device ready 
Register DO: 0000H=device not ready 


This function returns the status of the list device. Register 
DO contains either 0000H when the list device is not ready to accept 
a character or OOFFH when a character can be sent to the list 
device. 
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FUNCTION 16: SECTOR TRANSLATE 


Entry Parameters: 
Register DO.W: 10H 
Register Dl.wW: Logical Sector Number 


Register D2.L: Address of Translate 
Table 


Returned Value: ; 
Register DO.W: Physical Sector Number 


This function performs logical-to-physical sector translation, 
as discussed in Section 5.2.2. The Sector Translate function 
receives a logical sector number from register D1.W. The logical 
sector number can range, from 0 to the number of sectors per track-l. 
Sector Translate also receives the address of the translate table in 
register D2.L. The logical sector number is used as an index into 
the translate table. The resulting physical sector number is 
returned in DO.W. 


If register D2.L = Q0000000H, implying that there is no 
translate table, register Dl is copied to register DO before 
returning. Note that other algorithms are possible; in particular, 
is is common to increment the logical sector number in order to 
convert the logical range of 0 to n-l into the physical range of 1 
to n. Sector Translate is always called by the BDOS, whether the 
translate table address in the Disk Parameter Header is zero or 
nonzero. 
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FUNCTION 18: GET ADDRESS OF MEMORY 
REGION TABLE 


Entry Parameters: é 2 
Register DO.W: 12H 


Returned Value: . 
Register DO.L: Memory Region 
Table Address 


This function returns the address of the Memory Region Table 
(MRT) in register DO. For compatibility with other CP/M systems, 
P/M-68K maintains a Memory Region Table. However, it contains only 
ne region, the Transient Program Area (TPA). The format of the MRT 
is shown below: - 


Entry Count = 1} 16 bits 


32 bits 
32 bits > 


Figure 4-1. Memory Region Table Format 


Base address of first region 


Length of first region 


The memory region table must begin on an even address, and must 
be implemented. ; 
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FUNCTION 19: GET I/O BYTE 


Entry Parameters: 
Register DO.W: 138 


Returned Value: 
Register DO.W: I/O Byte Current 
Value 


This function returns the current value of the logical to 
physical input/output device byte (1/0 byte) in register DO.W. This 
8-bit value associates physical devices with CP/M~68K's four logical 
devices as noted below. Note that even though this is a byte value, 
we are using word references. The upper byte should be zero. 


Peripheral devices other than disks are seen by CP/M=68K as 
logical devices, and are assigned to physical devices within the 
BIOS. Device characteristics are defined in Table 4-3 below. 


Table 4-3. CP/M-68K Logical Device Characteristics 


_ 


CONSOLE . The interactive console that you use 
to communicate with the system is 
accessed through functions 2, 3 and 
4. Typically, the console is a CRT 
or other terminal device. 


LIST The listing device is a hard-copy 
device, usually a printer. 


AUXILIARY OCOTPUT An optional serial output device. 
AUXILIARY INPuT An optional serial input device. 


Note that a single peripheral can be assigned as the LIstT, 
AUXILIARY INPUT, and AUXILIARY OUTPUT device Simultaneously. If no 
peripheral device is assigned as the LIST, AUXILIARY INPUT, or 
AUXILIARY OUTPUT device, your BIOS should give an appropriate error 
message so that the system does not hang if the device is accessed 
by PIP or some other transient program. Alternatively, the 
AUXILIARY OUTPUT and LIST functions can simply do nothing except 
return to the caller, and the AUXILIARY INPUT function can return 
pep a-lAH (CTRL-Z) in register DO.W to indicate immediate end-o f- 

e. 
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The I/O byte is split into four 2-bit fields called CONSOLE, 
AUXILIARY INPUT, AUXILIARY OUTPUT, and LIST, as shown in Figure 4-2. 


most significant least significant D 


AUXILIARY AUXILIARY 
I/O Byte LIst OUTPUT INPUT CONSOLE 


Pigure 4-3. I/O Byte 


The value in each field can be in the range 0-3, defining the 
--gigned source or destination of each legical device. The values 
ich can be assigned to each field are given in Table 4-4. 


fable 4-4. I/O Byte Field Definitions 


CONSOLE field (bits 1,0) 


console is assigned to the console printer (TTY:) 
console is assigned to the CRT device (CRT:) 

batch mode: use the AUXILIARY INPUT as the CONSOLE 
input, and the LIST device as the CONSOLE output 
(BAT: ) 

3 usec defined console device (UC1:) 


nro 


AUXILIARY INPUT field (bits 3,2) 


Bit Definition 
0 AUXILIARY INPUT is the Teletype device (TTY:) 
Ll AUXILIARY INPUT is the high-speed reader device 
(PTR: ) 
2 user defined reader #1 (UR1:) 
3 


user defined reader #2 (UR2:) 


ALL Information Presented Here is Proprietary to Digital Research 


34 


Py are baer er nr nr ee 


coon 


Cy 


a 


CP/M-68K System Guide Function 19: Get I/O Byte 


Fable 4-4. (continued) 


AUXILIARY OUTPUT field (bits 5,4) : 
Bit . Definition 


AUXILIARY OUTPUT is the Teletype device (TTY:) 
AUXILIARY OUTPUT is the high-speed punch device (PTP:) 
user defined punch #1 (UP1:) 
user defined punch #2 (UP2:) 


LIST field (bits 7,6) 
a 


LIST is the Teletype device (TTY:) 
LIST is the CRT device (CRT:) 

LIST is the line printer device (LPTf:) 
user defined List device (UL1:) 


WNH OO 


WNre OO 


Note that the implementation of the I/0 byte is optional, and 
affects only the organization of your BIOS. No CP/M-68K utilities 
use the I/O byte except for PIP, which allows access to the physical 
devices, and STAT, which allows logical-physical assignments to be . 
made‘ and displayed. It is a good idea to first implement and test 

_ your BIOS without the IOBYTE functions, then add the I/O byte 
function. : 


~ 
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FUNCTION 20: SET I/O BYTE 


Entry Parameters: 
Register DO.W: 14H 
Register D1.W: Desired 


Returned Value: None 


This function uses the value in register Dl to set the value of 
the I/O byte that is stored in the BIOS. See Table 4-4 for the 1/0 
byte field definitions. Note that even though this is a byte value, 
we are using word references. The upper byte should be zero. 
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FUNCTION 21: FLUSH BUFFERS 


Entry Parameters: 
Register DO.W: 15H 


Returned Value: 
Register DO.W: 0000H=successful write 
Register DO.W: FFFFH=unsuccessful write 


This function forces the contents of any disk buffers that have 
been modified to be written. That is, after this function has been 
performed, all disk writes have been physically completed. After 
the buffers are written, this function returns a zero in register 
DO.W. However, if the buffers cannot be written or an error occurs, 
the function returns a value of FFFFH in register DO.W. 
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FUNCTION 22: SET EXCEPTION HANDLER ADDRESS 


Entry Parameters: 
Register DO.W: 16H 
Register D1.W: Exception Vector Number 
Register D2.L: Exception Vector Address 


Returned Value: 
Register DO.L: Previous Vector Contents 


This function sets the exception vector indicated in register 
DL.W to the value specified in register D2.L. The previous vector 
~alue is returned in register DO.L. Unlike the BDOS Set Exception 

sector Function (61), this BIOS function sets any exception vector. 
te that register Dl1.W contains the exception vector number. Thus, 
to set exception #2, bus error, this register contains a 2, and the 
vector value goes to memory locations 08H to OBH. 


End of Section 4 
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Section 5 
Creating a BIOS 


5.1 Overview 


The BIOS provides a standard interface to the physical 
input/output devices in your system. The BIOS interface is defined 
by the functions described in Section 4. Those functions, taken 
together, constitute a model of the hardware environment. Each BIOS 
is responsible for mapping that model onto the real hardware. 


In addition, the BIOS contains disk definition tables which 
define the characteristics of the disk devices which are present, 
and provides some storage for use by the BDOS in maintaining disk 
directory information. 


Section 4 describes the functions which must be performed by 
the BIOS, and the external interface to those functions. This 
Section contains additional information describing the structure and 


significance of the disk definition tables and information about) 


sector blocking and deblocking. Careful choices of disk parameters 
and disk buffering methods are necessary if you are to achieve the 
best possible performance from CP/M-68K. Therefore, this section 
should be read thoroughly before writing a custom BIOS. 


CP/M=-68K, as distributed by Digital Research, is configured to 
run on the Motorola EXORmacs development system with Universal Disk 
Controller. The sample BIOS in Appendix D is the BIOS used in the 
distributed system, and is written in C language. A sample BIOS for 
an Empirical Research Group (ERG) 68000 based microcomputer with 
Tarbell floppy disk controller is also included in Appendix B, and 
is written in assembly language. These examples should assist the 
rerder in understanding how to construct his own BIOS. 


e 


5-2 Disk Definition Tables 


As in other CP/M systems, CP/M-68K uses a set of tables to 
define disk device characteristics. This section describes each of 
these tables and discusses choices of certain parameters. 
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5.2.1 Disk Parameter Header 


Each disk drive has an associated 26-byte Disk Parameter Header 
(DPH) which both contains information about the disk drive and 
provides a scratchpad area for certain BDOS operations. Each drive 
must have its own unique DPH. The format of a Disk Parameter Header 
is shown in Figure 5-l. ‘ 
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Figure 5-1. Disk Parameter Header 


Each element of the DPH is either a word (16-bit) or longword 
32-bit) value. The meanings of the Disk Parameter Header (DPH) 
elements are given in Table 5-l. 


Table Sel. Disk Parameter Header Elements 


Description 


Address of the logical-to-physical sector 
translation table, if used for this particular 
drive, or the value 0 if there is no translation 
table for this drive (i.e, the physical and 
logical sector numbers are the same). Disk 
drives with identical sector translation may 
share the same translate table. The sector 
translation table is described in Section 5.2.2. 


0000 Three scratchpad words for use within the BDOS. 


DIRBUF Address of a 128=byte scratchpad area for 
directory operations within BDOS. All DPHs 
address the same scratchpad area. 


“DPB Address of a disk parameter block for this drive. 
Drives with identical disk characteristics may 
address the same disk parameter block. 
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Table S-1. (continued) 


Address of a checksum vector. The BDOS uses this 
area to maintain a vector of directory checksums 
for the disk. These checksums are used in 
detecting when the disk in a drive has been 
changed. If the disk is not removable, then it 
is not necessary to have a checksum vector. Each 
DPH must point to a unique checksum vector. The 
checksum vector should contain 1 byte for every 
four directory entries (or 128 bytes of 
directory). In other words: length (CSV) 3 
(DRM+1) / 4. (DRM is discussed in Section 
5.2.3.) - 


Address of a scratchpad area used by the BDOS to 
keep disk storage allocation information.’ The 
area must be different for each DPH. There must 
be 1 bit for each allocation block on the drive, 
requiring the following: length (ALV) = (DSM/8) + 
1. (DSM is discussed below.) 


§.2.2 Sector Translate Table 


Sector translation in CP/M-68K is a method of logically 
renumbering the sectors on each disk track to improve disk I/0 
performance. A frequent situation is that a program needs to access 
disk sectors sequentially. However, in reading sectors 
Sequentially, most programs lose a full disk revolution between 


‘sectors because there is not enough time between adjacent sectors to 


begin a new disk operation. To alleviate this problem, the 
traditional CP/M solution is to create a logical sector numbering 
scheme in which logically sequential sectors are physically 
Separated. Thus, between two logically contiguous sectors, there is 
a several sector rotational delay. The sector translate table 
defines the logical-to-physical Mapping in use for a particular 
drive, if a mapping is used. 


Sector translate tables are used only within the BIOS. Thus 
the table may have any convenient format. (Although the BDOS is 
aware of the sector translate table, its only interaction with the 
table is to get the address of the sector translate table from the 
DPH and to pass that address to the Sector Translate Function of the 
BIOS.) The most common form for a sector translate table is an a- 
byte (or n-word) array of physical sector numbers, where n is the 
number of sectors per disk track. Indexing into the table with the 
logical sector number yields the corresponding physical sector 
number. 
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Although you may choose any convenient log ical-to-physical 
Mapping, there is a nearly universal mapping used in the CP/M 
community for single-sided, Single-density, 8-inch diskettes. That 
mapping is shown in Figure 5-2. Because your choice of mapping 
affects diskette compatibility between different systems, the 
mapping of Figure 5-2 is strongly recommended. > 


Legical Sector Oo 123 4 5 6 7 8 9 10 11 12 
Physical Sector L 713 19 25 51117 23 3 915 21 


Logical Sector| 13 14 15 16 17 18 19 20 21 22 23 24 25 
Physical Sector 2 814 20 26 612 18 24 #410 16 22 


Figure S-2. Sample Sector Translate Table 


2-3 Disk Parameter Block 


A Disk Parameter Block (DPB) defines several characteristics 
associated with a particular disk drive. Among themare the size of 
the drive, the number of sectors per track, the amount of directory 
space, and others. 


~@isks are identical in definition. A discussion of the fields of 
the DPB follows the format description. The format of the DPB is 
shown in Figure 5-3. 


Ea 


8b 16b 


A Disk Parameter Block can be used in one or more DPH's if the ) 


Pigure 5-3. Disk Parameter Block 


Bach field is a word (16 bit) or a byte (8 bit) value. The 
description of each field is given in Table 5-2. 


Table 5-2. Disk Parameter Block Fields 


Definition ) 


Number of 128—byte logical sectors per track. 


Tte block shift factor, determined by the data 
block allocation size, as shown in Table 5-3. 
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Table 5-2. (continued) 


eninies 


The block mask which is determined by the data 
block allocation size, as shown in Table 5-3. 


The extent mask, determined by the data block 
allocation size and the number of disk Dleocks, as 
shown in Table 5-4. 


Reserved byte. 


Determines the total storage capacity of the disk 
drive and is the number of the last block, 
counting from 0. That is, the disk contains 
DSM+1 blocks. 


Determines the total number of directory entries 
which can be stored on this drive. DRM is the 
number of the last directory entry, counting from 
OQ. That is, the disk contains DRM+1L directory 
entries. Each directory entry requires 32 bytes, 
and for maximum efficiency, the value of DRM 
should be chosen so that the directory entries 
exactly fill an integral number of allocation 
units.. : 


CkKS The size of the directory check vector, which is 
zero if the disk is permanently mounted, or 
length (CSV) = (DRMA)/ 4 €4% for removable media. 


OFF The number of reserved tracks at the beginning of 
a logical disk. This is the number of the track: 
on which the directory begins. 


To choose appropriate values for the Disk Parameter Block 
elements, you mist understand how disk space is organized in CP/M- 
68K. A. CP/M~68K disk has two major areas: the boot or system 
tracks, and the file system tracks. The boot tracks are usually 


‘used to hold a machine-dependent bootstrap loader for the Operating 


System. They consist of tracks 0 to OFF-l1. Zero is a legal value 
for OFF, and in that case, there are no boot tracks. The usual 
value of OFF for 8-inch floppy disks is two. : 


The tracks after the boot tracks (beginning with track number 
OFF) are used for the disk directory and disk files. Disk space in 
this area is grouped into units called allocation units or blocks. 
The block size for a particular disk is a constant; called BLS. BLS 
may take on any one of these values: 1024, 2048, 4096, 8192, or 
16384 bytes. No other values for BLS are alloved. (Note that BLS 
does not appear explicitly in any BIOS table. However, it 
determines the values of a number of other parameters.) The DSM 


_ field in the Disk Parameter Block is one less than the number of 
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Blocks on the disk. Space is allocated to a file or to the 
directory in whole blocks. No fraction of a block can be allocated. 
block size 


The choice of BLS, is very important, because it effects the 
efficiency of disk space utilization, and because for any disk size 
there is a minimum value of BLS that allows the entire disk to be 
used. Each block on the disk has a block number ranging from 0 to 
DSM. The largest block number allowed is 32767. Therefore, the 
largest number of bytes that can be addressed in the file system 
space is 32768 * BLS. Because the largest allowable value for BLS 
is 16384, the biggest disk that can be accessed by CP/M=-68K is 
1638 4* 32768 = 512 Mbytes. 


Each directory entry may contain either 8 block numbers (if DSM 
>s 256) ce 16 block numbers (if DSM < 256). Each file needs enough 
directory entries to hold the block numbers of all blocks allocated 
to the file. Thus a large value for BLS implies that fewer 

rectory entries are needed. Since fewer directory entries are 
ed, the directory search time is decreased. 


The disadvantage of a large value for BLS is that since files 


are allocated BLS bytes at a time, there is potentially a large 


unused portion of a block at the end of the file. If there are many 
small files on a disk, the waste can be very significant. 


The BSH and BLM parameters in the DPB are functions of BLS. 
Once you have chosen BLS, you should use Table 5-3 to determine BSH 
and BLM. The EXM parameter of the DPB is a function of BLS and DSM. 
You should use Table 5-4 to find the value of EXM for your disk. 


Table 5-3. BSH and BIM Values 
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Table S-4. EXM Values 


The DRM entry in the DPB is one less than the total number of 
directory entries. DRM should be chosen large enough so that you do 
not run out of directory entries before running out of disk space. 
It is not possible to give an exact rule for determining DRM, since 
the number of directory entries needed will depend on the number and 
sizes of the files present on the disk. 


The CKS entry in the DPB is the number of bytes in the CSV 
(checksum vector) which was pointed to by the DPH. If the disk is 
not removable, a checksum vector is not needed, and this value may 
be zero. — ; 


5-3 Disk Blocking 


When the BDOS does a disk read or write Operation using the 
BIOS, the.unit of information read or written is a 128=-byte sector. 
This may or may not correspond to the actual physical sector size of 
the disk. If not, the BIOS must implement a method of representing 
the 128=byte sectors used by CP/M-68K on the actual device. Usually 
if the physical sectors are not 128 bytes long, they will be some 
multiple of 128 bytes. Thus, one physical sector can hold some 
integer number of 128<byte CP/M seczors. In this case, any disk I/O 
will actually consist of transferring several CP/M sectors at once. 


It might also be desirable to do disk I/O in units of several 
128=byte sectors in order to increase disk Shroughput by decreasing 
rotational latency. (Rotational latency is the average time it 
takes for the desired position on a disk to rotate around to the 
read/write head. Generally this averages 1/2 disk revolution per 
transfer.) Since a great deal of disk 1/0 is sequential, rotational 
latency can be greatly reduced by reading several sectors at a time, 
and saving them for future use. 


In both the cases above, the point of interest is that physical 
I/O occurs in units larger than the expected sector size of 128 
bytes. Some of the problems in doing disk I/O in this manner are 
discussed below. 


ALL Information Prasentad Jere is Proprietary to Digital Research 


CesM-OOK SyYSteM GUlde 5.3 Disk Blocking 


5.3.1 A Simple Approach 


This section presents a simple approach to handling a physical 
sector size larger than the logical sector size. The method 
discussed in this section is not recommended for use in a real BIOS. 
Rather, it is given as a starting point for refinements discussed in 
the following sections. Its simplicity also makes it a logical 
choice for a first BIOS on new hardware. However, the disk 
throughput that you can achieve with this method is poor, and the 
refinements discussed later give dramatic improvements. 

Probably the easiest method for handling a physical sector size 
which is a multiple of 128 bytes is to have a Single buffer the size 
of the physical sector internal to the BIOS. Then, when a disk read 
is to be done, the physical sector containing the desired 128-byte 
logical sector is read into the buffer, and the appropriate 128 
bytes are copied to the DMA address. Writing is a little more 
complicated. You only want to put data into a 128-byte portion of 
the physical sector, but you can only write a whole physical sector. 
Therefore, you mist first read the physical sector into the BIOS's 
buffer; copy the 128 bytes of Output data into the proper 128-byte 
piece of the physical sector in the buffer; and finally write the 
entire physical sector back to disk. 


Note: this operation involves two rotational latency delays in 
addition to the time needed to copy the 128 bytes of data. In fact, 
the second rotational wait is probably nearly a full disk 
revolution, since the copying is usually mich faster than a disk 
revolution. 


5.3.2 Some Refinements 


There are some easy things that can be done to the algorithm of 


Section 5.2.1 to improve its performance. The first is based on the 
fact that disk accesses are usually done sequentially. Thus, if 
data from a certain physical sector is néeded, it is likely that 
another piece of that sector will be needed on the next disk 
operation. To take advantage of this fact, the BIOS can keep 
information with its physical sector buffer as to which disk, track, 
and physical sector (if any) is represented in the buffer. Then, 
when reading, the BIOS need only do physical disk reads when the 
information needed is not in the buffer. 


On writes, the BIOS still needs to preread the physical sector 
for the same reasons discussed in Section 5.2.1, but once the 
Physical sector is in the buffer, subsequent writes into that 
physical sector do not require additional prereads. An additional 
Saving of disk accesses can be gained by not writing the sector to 
the disk until absolutely necessary. The conditions under which the 
physical sector must be written are discussed in Section 5.3.4. 
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5.3.3 Track Buffering 

Track buffering is a special case of disk buffering where the 
T/O is done a full track at a time. When sufficient memory for 
several full track buffers is available, this method is quite good. 
The method is essentially the same as discussed in Section §.3.2, 
but there are some interesting features. First, transferring an 
entire track is much more efficient than transferring a single 
sector. The rotational latency is incurred only once for the entire 
track, whereas if the track is transferred one sector at a’time, the 
rotational latency occurs once per sector. On a typical diskette 
with 26 sectors per track, rotating at 6 cevolutions per second, the 
difference in rotational latency per track is about 2 seconds versus 
a twelfth of a second. Of course, in applications where the disk is 
accessed purely randomly, there is no advantage because there is a 
low probability that more than one sector will be used froma given 
track. However, such applications are extremely rare. 


5.3.4 LRU Replacement 


With any method of disk buffering using more than one buffer, 
it is necessary to have some algorithm for Managing the buffers. 
That is, when should buffers be filled, and when should they be 
written back to disk. The first question is simple, a buffer should 
be filled when there is a request for a disk sector that is not 
Presently in memory. The second issue, when to write a buffer back 
to disk, is more complicated. , 


Generally, it is desirable to defer writing a buffer until it 
becomes necessary. Thus, several transfers can be done to a buffer 
for the cost of only one disk access, two accesses if the buffer had 
to be preread. However, there are several reasons why buffers must 
be written. The following list describes the reasons: 


1) A BIOS Write operation with modeel (write to directory 
sector). To maintain the integrity. of CP/M<68K's file 
system, it is very important that directory information on 
the disk is kept up to date. Therefore, all directory 
writes should be performed immediately. 


2) A BIOS Flush Buffers operation. This BIOS function is 
explicitly intended to force all disk buffers to be 
written. After performing a Flush Buffers, it.is safe to 
remove a disk from its drive. 


3) A disk buffer is needed, but all buffers are full. 
Therefore some buffer must be emptied to make it available 
for reuse. , 


4) A Warm Boot cecurs. This is Similar to number 2 above. 
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Case three above is the only one in which the BIOS writer has 
any discretion as to which buffer should be written. Probably the 
best strategy is to write out the buffer which has been least 
recently used. The fact that an area of disk has not been accessed 


for some time is a fairly good indication that it will not be needed | 


again soon. ! 


5.3.5 The New Block Flag 


As explained in Section 5.2.2, the BDOS allocates disk space to 
files in blocks of BLS bytes. When such a block is first allocated 
to a file, the information previously in that block need not be 
preserved. To enable the BIOS to take advantage of this fact, the 
BDOS uses a special parameter in calling the BIOS Write Function. 
If register D1L.W contains the value 2 on a BIOS Write call, then the 
write being done is to the first sector of a newly allocated disk 
block. Therefore, the BIOS need not preread any sector of that 
block. If the BIOS does disk buffering in units of BLS bytes, it 
tan Simply mark any free buffer as corresponding to the disk address 
specified in this write, because the contents of the newly allocated 
bleck are not important. If the BIOS uses a buffer size other than 
BLS, then the algorithm for taking full advantage of this 
information is more complicated. 


This information is extremely valuable in reducing disk delays. 
Consider the case where one file is read sequentially and copied to 
a newly created file. Without the information about newly allocated 
disk blocks, every physical write would require a preread. With the 


information, no physical write requires a preread. Thus, the number 


af physical disk operations is reduced by one third. 


End of Section 5 
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Section 6 
Installing and Adapting 
the Distributed BIOS and CP/M-68K 


6.1 Overview 


The process of bringing up your first running CP/M-68K system 
is either trivial or involved, depending on your hardware 
environment. Digital Research supplies CP/M-68K in a form suitable 
for booting on a Motorola EXORmacs development system. I£ you have 
an EXORmacs, you can read Section 6.1 which tells how to load the 
distributed system. Similarly, you can buy or lease some other 
machine which already runs CP/M-68K. | 


If you do not have an EXORmacs, you can use the S-record files 
Supplied with your distribution disks to bring up your first CP/M-~- 
68K system. This process is discussed in Section 6.2. 

6.2 Booting on an EXORmacs 

The CP/M=68K disk set distributed by Digital Research includes 

disks boot and run CP/M-68K on the Motorola EXORmacs. You can use 


the distribution system boot disk without modification if you have a 
Motorola EXORmacs system and the following configuration: : 


1) 128K memory (minimum) 


2) a Universal Disk Controller (UDC) or Floppy Disk Controller 
(PDC) - 


3) a single-density, IBM 3740 compatible floppy disk drive 


4) an ExORterm 
To. load CP/M=68K, do the following: 
1) Place the disk in the first floppy drive (#FD04 with the upc 


Or #FD00 with the FDC). 


2) Press SYSTEM RESET (front panel) and RETURN (this brings in 
MACSbug) . 


3) Type "BO 4" if you are using the UDC, “BO 0" if you are 
using the FDC, and RETURN. CP/M=68K boots and begins 
running. * 8 . 


C) 


i 
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6.3 Bringing Up CP/M-68K Using the S-record Files 


The CP/M--68K distribution disks contain two copies of the CP/M~ 
68K operating system in Motorola S-record form, for use in getting 
your first CP/M-68K system running. S-records (described in detail 
in Appendix F) are a simple ASCII representation for absolute 
programs. The two S-record systems contain the CCP and BDOS, but no 
BIOS. One of the S~record systems resides at locations 400H and up, > 
the other is configured to cccupy the top of a 128K memory space. 
(The exact bounds of the S-record systems may vary from release to 
release. There will be release notes and/or a file named README 
describing the exact characteristics of the S-record systems 
distributed on your disks.) To bring up CP/M-68K using the S-record 
files, you need: . 


1) some method of down-loading absolute data into your target 
system 


2) a computer capable of reading the distribution disks (a 
CP/M-based computer that supports Standard CP/M 8=inch 
diskettes) 


3) a BIOS for your target computer 


Given the above items, you can use the following procedure to 
bring a working version of CP/M-68K into your target sy stem: 


-1) You must patch one location in the S-record system to link ) 
it to your BIOS's _init entry point. This location will be 
specified in release notes and/or in a README file on your 
distribution disks. The patch simply consists of insecting 
the address of the _init entry in your BIOS at one long 
word location in the S-record system. This patching can be 
done either before or after down-loading the systen, 
whichever is more convenient. 


2) Your BIOS needs the address of the ccp entry point in the 
S-rcecord system. This can be obtained from the release 
notes and/or the README file. 


3) Down-load the S-record system into the memory of your target 
computer. . 


4) Down-load your BIOS into the memory of your target computer. 
5) Begin executing instructions at the first location of the 
down-loaded S-record system. 


Now that you have a working version of CP/M-68K, you can Us? 
the tools provided with the distribution system for furthec 
development. ; 


End of Section 6 
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Section 7 
Cold Boot Automatic Command Execution 


7.1 Overview 


The Cold Boot Automatic Command Execution feature of CP/M=-68K 
allows you to configure CP/M-68K so that the CCP will automatically 
execute a predetermined command line on cold boot. This feature can 
be used to start up turn-key systems, or to perform other desired 
operations. 


7.2 Setting up Cold Boot Automatic Command Execution 


The CBACE feature uses two global symbols: _autost, and 
—Ssercmd. These are both defined in the CCP, which uses them on 
cold boot to determine whether this feature is enabled. If you want 
to have a CCP command automatically executed on cold boot, you 
should include code in your BIOS's init routine (which is called at 
cold boot) to do the following: : Bee fk eae I ee ee 


cio fa eC rake f oh Boe 


ae 
} a 
é 1) The byte at autost must be set to the value 018. 
‘ 2) The command line to be executed must be Placed in memory at 
Be ~Usercmd and subsequent locations. The command must be 
g “terminated with a NULL (00H) byte, and may not exceed 128 
os bytes in length. All alphabetic characters in the command 
Fie aed line should be upper-case. 


Once you write a BIOS that performs these two functions, you 
can build it into a CPM.SYS file as described in Section 2. This 
system, when booted, will execute the command you have built into 

i it. 


* 


End of Section 7 
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Section 8 
The PUTBOOT Utility 


8.1 PUTBOOT Operation 

The PUTBOOT utility is used to copy information (usually a 
bootstrap loader system) onto the syStem tracks of a disk. Although 
PUTBOOT can copy any file to the system tracks, usually the file 
*being written is a program (the bootstrap system). 
8.2 Invoking PUTBOOT 

Invoke PUTBOOT with a command of the form: 

PUTBOOT [-H] <filename> <drive> 
where 
@ -H is an optional flag discussed below; 


e@ <filename> is the name of the file to be written to the system 
tracks; 


e <drive> is the drive specifier for the drive to which 
~ <filename> is to be written (letter in the range A=-P.) 


v) 


PUTBOOT writes the specified file to the System tracks of the 
specified drive. Sector skewing is not used; the file is written to 
the system tracks in physical sector number order. 


Because the file that is written is normally in command file 
format, PUTBOOT contains special logic to strip off the first 28 
bytes of the file whenever the file begins with the number 601AH, 
the magic number used in command files. If; by chance, the file to 
be written begins with 601AH, but should not have its first 28 bytes 
discarded, the -H flag should be specified in the PUTBOOT command 
line. This flag tells PUTBOOT to write the file verbatim to the 
System tracks. 


‘ PUTBOOT uses BDOS calls to read <filename>, and used BIOS calls 
to write <filename> to the system tracks. It refers to the OFF and 
SPT parameters in the Disk Parameter Block to determine how large 
the system track space is. The source and command files for PUTBOO 
G are supplied on the distribution disks for CP/M-68K. 


End of Section 8 
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_ BIOS.C C language source for the EXORmacs BIOS as 


Appendix A 
Contents of Distribution Disks 


This appendix briefly describes the contents of the disks 


that contain CP/M-68K as distributed by Digital Research. 


Table A-1. Distribution Disk Contents 


AR68 .REL Relocatable version of the 
archiver/librarian. 


AS68INIT Initialization file for assembler—see 


AS68 documentation in the CP/M~63K 
Operating System Programmer's Guide. 


AS68 .REL Relocatable version of the assembler. 


ASM.SUB Submit file to assemble an assembly 
program with file type .S, put the object 
code in filename.O, and a listing file in 
filename.PRN. 


BIOS .O 


Object file of BIOS for EXORmacs. 


distributed with CP/M-68K. 


BIOSA.O Object file for assembly portion of 
EXORmacs BIOS. 


BIOSA.S Source for the assembly language portion 
of the EXORmacs BIOS as distributed with 


CP/M~68K. 
BIOSTYPS .# Include file for use with BI0s.c. 
BOOTER .O Object for EXORmacs bootstrap. 


BOOTER.3 


Assembly boot code for the EXORmacs. 


C.SUB Submit file to do a C compilation. 
Invokes all three passes of the C compiler 
as well as the assembler. You can compile 
aC program with the line: A>C filename. 


C068 .REL Relocatable version of the C parser. 


C168 .REL Relocatable version of the C code 
generator. i 
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Table A-l. (continued) 


CLIB The C run-time library. 


CLINK.SUB Submit file for linking C object programs 
with the C run-time library. 


CP68 .REL Relocatable version of the C preprocessor. 


CPM.H Include file with C definitions for CP/M-~ 


68K. See the C Programming Guide for 


CP/M-68K for details. 
Relocatable version of CPM.SYS. 


CPM.REL 


CPM.SYS CP/M-68K operating system file for the 
EXORmacs. 


CPMLIB Library of object files for CP/M-68K. See 
Section 2. 


CPMLDR.SYS The bootstrap loader for the EXORmacs. A 
copy of this was written to the system 
tracks using PUTBOOT. 


Same as above. 


Relocatable version of the preloader for 
DDT . (Loads DDT1 into the high end of 
the TPA.) 


DDT 1. 68K This is the real DDT that gets loaded into 
the top of the TPA. [It is relocatable 
even though the file type is .68K, because . 
it must be relocated to the top of the TPA 
each time it is used. 


DUMP .REL Relocatable version 


of the DUMP utility. 


ED .REL Relocatable version of the utility. S 
_ELDBIOS .S -Assembly language source for the ERG a 


sample loader BIOS. 


ERGBIOS .S 


Assembly language source for the ERG 
sample BIOS. 


ERRNO .H Same as above. 


PORMAT .REL Relocatable disk formatter for the 


Motorola EXORmacs. 
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FORMAT .S 


“INIT.REL 


INIT.S 
LCPM.SUB 


LDBIOS.O 
LDBIOSA.O 


LDBIOSA.S 


LORLIB 


L068 .REL 
LOADBIOS .# 


LOADBIOS .SUB 
MAKELDR. SUB 
NORMBIOS .# 
NORMBIOS . SUB 
NM68 .REL 


PTP .REL 
PORTAB .H 
. PUTBOOT .REL 
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Table A-1. (continued) 


Assembly language source for the FORMAT 
utility. 


Relocatable version of the INIT utility. 


Assembly language source, for the INIT 
utility. 


Submit file to create CPM.REL for 


_EXORmacs. 


Object file of loader BIOS for EXORmacs. 


Object file for assembly portion of 
EXORmacs loader BIOS. 


_ Source for the assembly language portion 


of the EXORmacs loader BIOS as distributed 
with CP/M-68K. 


Library of object files for creating a 
Bootstrap Loader. See Section 3. 


Relocatable version of the linker. 


Include file for use with BIOS.C, to make 
it into a loader BIOS. 


Submit file to create loader BIOS for 
EXORmacs. ° 


Submit file to create CPMLDR.SYS on 
EXORmacs. 


Include file for use with BIOS.C, to make 
it into a normal. BIOS 


Submit file to create normal BIOS for 
EXORmacs. ; 


Relocatable version of the symbol table 
dump utility. 


Relocatable version of the PIP utility. 
Same as above. 4 


Relocatable version of the pPUTBOOT 
utility. : 
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Assembly renga source for the PUTBOOT. 
utility. 


ASCII file containing information relevant » 
to this shipment of CP/M-68K. This file 
might not be present. 


Submit file to relocate CPM.REL into 
CPM.SYS. 


Relocatable version of the command file 
relocation utility. 


This file is included on each disk that 
contains .REL command files. (x is the 
numer of the distribution disk containing 
the files). It is a submit file which | 
will relocate the .REL files for the- 
target system. 


§ .0 Startup routine for use with C programs-— 
must be first object file linked. 


SENDC 68 .REL Relocatable version of the S-record 
creation utility. ~ : -) 


SETIMP .8 Same as above. 

SIGNAL .H Same as above. 

SIZE68 .REL Relocatable version of the SIZE68 utility. 

SR128K.SYS S-record version of CP/M~68K. This 
version has no BIOS, and is provided for 
use in porting CP/M-68K to new hardware. 

SR400.S¥S S-record’ version of CP/M-68K. This 
version has no BIOS, and is provided for 
use in porting CP/M-68K to new hardware. 

STAT .REL Relocatable version of the STAT utility. 

STDIO.# Include file with standard 1/0 definitions 


for use with C programs. See the Cc 
Programming Guide for CP/M-68K for 


details. “) 


End of Appendix A 
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en eee Oe ea ee Oe ee eee ee eS Ee eT ee re ee oe 


- esha 


ce/s 6 8 


1 

2 

3 

4 

$ 

6 

7 

8 

9 

10 

135 
12 00000000 
13 0000000A 
14 9000000C 
15 
16 

17 goo0000E 
18 00000012 
139 00000014 
20 
21 
22 
23 


00000016 
Q000001A 


o000001C 


26 00000012 
27 00000022 

28 00000026 

29 0000002A 

ee: 30 0000002 
; 31 00000032 
\, 32 00000036 
cet 33 0000003 
34 00000038 

_ 35 00000042 

36 oooo0046 

37 00000040 

38 ooo0004 

39 00000052 

40 00000086 

41 000000SA 


C) 


Appendix B 
Sample BIOS Written in Assembly Language 


000 Asseazbdier Revision 02.01 
Soucce Pile: a:sergbdios.s 


Page L 


SHSSSSSHSHSSHSSHSSSSSSHSSSSSHSHSSSHTSEHSSSHNHSCEHAEESEESTAAEEHTASELTeESEFEeSe 


e 

e CP/M-68K aros « 

e Basic [nput/Oucput Subsystes e 

. For ERG 68000 wath Tacbell floppy disk controller © 

e e 

SSS SHSSSHRSESSSHSSHSHHSSESSHSHHSHASSHSSSHHRSELSSEHOSGezeaeeeeseaeeereee -_ 

-globl _init * bios initialization entry point 
-GgloblL _cep * cep enery pointe 

23PCOO0Q0COEDONN0RSC init: move.l ¢traphndl,$8e * set up trap $3 handler 
4280 ele.l do * log on disk A, usec 0 
4u7s cts 

traphandl: 
06400017 capi tnfuncs,d0 
6408 bec trapng 
e548 ish $2,d0 * multiply bios function by 4 
20780006 movea.l 6(pc,d0},a0 © get handler address 
4890 jst (ad) * call handler 

trapngs 
4873 cts 

biocsdase: ' 
eo000c0e -de.b _init { 
0000007A -de. wooot j 
00000080 -dc.l constae q 
00000094 -de.l conin 
oa0000as -de.l conout 
aq0cconc -de.l lstout 
go0000se i -d@c.l1 gua 
aooco0ce -de.l = rde 
eaococcs -de.l hose 
090000000 ‘s - .dewl seldsk 
ooooo0rs -de.L seetrk 
00000100 -de.l setsec 
00000114 -d¢c.l setdma 
0000011C -de.l coad 
000001SEB -de.l weite 
a00000c2 -de.l lLisese 
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42 Q00000SZ 00000108 -de.l sectran 

43 00000062 00000114 -@c.L setdma 

44 00000066 0000029¢ -de.l getseg 

4$ GO00GOGA 000002A46 -de.l geciod 

46 QOOOCOSGE OCO0RG2A6 -de.l setiod 

47 90000072 30000296 -de.l fClusn 

48 00000076 900002A8 : -de.l setexe 7 

49 oe 
so nfuncse (*-biosbdase) /4 si ) 
$2. 
$2 QOOGOO7TA 4e7900000000 woeet: jap cep 
$3 
$4 00000080 1LO3900FFFFOL constat: move.d S&fff01,d0 * get status byte 
$5 00000086 02400002 | andi.w $2,d0 * data available bit on? 

Cp/M 68000 Assemdiecr Revision 02.01 Page 2 
Source Pile: azsergbios.s 
$6 Q000008A 6704 beq noton ® branch if not 
$7 goo0008C 7001 moveq.l #$1,d0 © set cesult to true 
$8 QQQO0O8E 47S ets 
$9 
60 00000090 4280 noton: clr.) do * set cesult co false 
61 00000092 4275 cts 
62 
63 00000094 61£A conin: bse constat © see if key pressed 
64 00000096 4A40 ese a0 
65 00000096 67FA > beq conin * wait until key pressed 
66 O00C009A LO390CFFFFOO gove.b S££tt00,dd * get key 
67 G00Q00A0 Cosc0000007F and.1l 9$7£,d0 ® cleac all but low 7 bits 
68 QOOQQQ0AS 4275 “ets 
69 
7Q OOOOOOAS 103900FFFFOL conout: wove.b S$ff&£t01,dd © gee status 
71 O0QO0CAZ CO3ICOQOL and.b $$1,d0 * check fore ceransmitter buffer empty 
72 000000B2 67F4 ; beq conouc * wait uneil ouc port has aged... 
73 00000084 13CclLOOFFFFOO aove.5 dl,Stf£f&£00 * and output ic 
ae QOQQQOBA 4£75 tts * and exit 
76 o00000B8C 4275 Istoue: ets 
1? 
o000ccBe 4275 puns cts 
= 000000C0 4£75 ede: cts * 

1 ’ 
82 000000C2 LO3ICOOFF listst: sove.b #S£f,d0 : 
4 Q00000C5 4875 . ets : a 
85 ° < : 
: * Disk Sandlecs foc Tarbell 1793 ECloppy disk controller 

® 
es maxdsk = 2 © this 8I0$ supports 2 Eloppy drives 
oe dpnlien = 26 ® Llengeh of disk pacamerec header 
+ | 
ot iobese = $ogcerees © Tacbetl floppy disk port base address 
92 : dead = tovase © outpuc port for command + 


Listing B-1. (continued) 
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Orme 2 meme we ee ee eee 
ne eer Ce ne 8 ee 


1 TE EE nage == 
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93 dstac = iovase * input stacus port 
94 dtrk * tobaserl * disx track poce 
95 dsect = iodase+2 © disk sector port 
96 ddata = iobase+3 © disk data port 
97 dwait = iobases4 * input pore to wait foe op finished 
98 dentrl © jiobaser4 * output control port foe drive selection 
go 99 
2 100 , 
1021 Qad000Cs 423900000002 hone: elre.d track a 
_—_ 102 QOCOOOCE 4275 ets 
103 
104 seldsk: 
105 e select disk given by cegister dl.b 
106 009000000 7000 moveq #0,d0 . 
107 G0000002 323c0002 enp.d bmaxdsx,dl * valid deceive number? 
108 00000006 6AlLE bel selctn * if ao, ceturn 0 in do 
109 00000008 13c100000000 move.5 di,seldrv © else, save deceive nuapec 
110 000000De 2909 isl.b 64,41 
cCr/M™ 63aoo0a AsSsemblec Revision 02.01 Page 3 
Source 7ile: asecgoios.s : 
LLL 00000020 13C1L0000000A move. dl,selcode * selece code is 00 foe dev 9, $10 for dev Ll 
LL2 O00G00E6 103900000000 move.b seldrv,d0 . 
113 QOGOGOEC COFCOUOLA g@ulu fdpn len ,do . 
114 G00000F0 DOBCO00COOLES add.l tdpnod, do * poine dO ae correct dpn 
115 000000F6 4E75 seletn: cts 
116 
LLr9ee000r8 13¢€100000002 settrck: move.b dl,track 
118 QO0000TZ 4875 ets 
119 
120 Q0000L00 L3CLOO000003 setsec: move.d dl,sector 
L2L O0000L06 4275 ets 
. 122 
123 sectran: 
124 e translate sectoce in dl with transiace table pointed to oy d2 
125 ® cesult in dd 
126 0Q000L08 2042 movea.l d2,a0 
< : 127 QOQOOLOA 48CL exe.l dL 
" 128 Q0000L0C 10301000 move.b #0(a0,dL),d0 
: 129 QOOOCOLLO 48CcO0 ext..l do 
ws 130 00000112 4275 ets 
: — 131 ; 
aa 132 secdaa: ; : 
: \ if 133 go00aL1s 23C¢ Loco00006 move.l dl.dma 
tee 114 QQOOOLLA 4275 : cts : : : 
: 13s . 
; 136 cead: s 
137 © Read one sector from cequested disk, track, sector to das address 
. Lis © Retry if necessary, cetucn in d0 00 if ox, else non-zeco 
‘ 139 QQQ00LLC LiFcogoAgGOaCOOS @ove.b t10,ecrcne * set up cetcy countec 
140 ccetcy: : 
141 00000124 41000076 bse setup 
242 90000128 00430088 . ori $888.43 * OR cead command with head load dit 
143 Q00001L2C Licioorrrres aove.b d3,demd * output ic to FOC 


Listing B-l. (continued) 


rae rs 


+ Seatbetnnge Sky sa 


as 
Neus 
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00000132 
Q000013A 
e000013¢ 
90000142 


90000144 
00000148 
GOOOO1L4A 
ao0c00 ld 
Qoo00ol4E 
90000152 
00000158 
OOQOOLSA 
0000015¢ 


oocoolsse 


00000 166 
00000168 
cPp/sa 68 
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08390007 Oorrrrrc 
6708 
LOPOOOrrrrrs 
60ZE 


61000146 
6604 

4280 - 

4B75 
61000080 
$3390000000B 
660A 

70°F 

4875 


13FC000A0000000B8 


6134 
004300A8 
aq0a 


Source Pile: a:ergbios.s 


00000 16¢ 
00000172 
8 QOQ00L7A 
9 Q00D0L7C 


Q 00000182 6 


900001384 
00000188 
Q000018A 
0000018¢ 
0000018E 
00000190 
00000196 
00000198 
0000019A 


0000019¢ 
GOO0O0 LAS 
90000 LAA 
00000 1B0 
occod la2 
00000iss 
90000 LBE 
a00001Ccs 
900001¢2 
QOQQ01CA 
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L3cJoorrrrrs © 
0839000700FFFFFC 
6708 
L3IOsoorFrrrs 

OES 


$1000 106 


333900000008 
66CE 
70PP 
4E75 


Lorcoonooorrrrrs 
16 3900000001 
863900000000 
GB1LA 
163900000002 
363900000003 
6620 

4283 

0839000 S00FrrFrrrs 
6618 


Assembdblec 


sove.5 
ora 


base 

! bne 
ele.l 

ces 

recroc: dsr 


weites 


B Sample 


87, dwait 
tdoene 
ddata, (a0) 
cleop 


estacus bd 
ceercoe 
aa 


eerchk = 
bl,ecrene 


eretry 
eseeceeee[e, dd 


Assembly Language BIOS. 


if end of cead, exit 
else, saove next byte of data 


geet FOC status 


go to erroc handler 


* Weite one sectoe to requested disk, track, sectors from dma address 
* Retry if necessary, cetucn in dQ 00 if ok, else non-zero 


sove.b 
weetry: 
bse 
oci 


wloop: bese 


setugr 


$10,ecccne 


setup 
#$aa,d3 bd 


Revision 02.01 


43, dead bd 

67, ,dwait 

wdone ¢ 

(a0)*,ddata e 

wloop 

estatus e 
‘ werrcot 

c-1] 

errchk ° 

@L,eccene 

weetry 

eseececete’,do 


© set up cetry counter 


OR weite command with heed load bit 


Page 4 


outpuc it to Foc 


if end of cead, exit 
else, move next byte of data 


get FOC status 


go to erroe 


© common cead and write setup code 


* select disk, 
aove.b 


Listing 8-1. 


set track, set 
$S$da0,dend ° 
curdev,d3 
seldev, a3 
newdc ive ° 
erack,d3 
oldtck,d3 
newtrk bd 


$S,dstact 
sexit 


62 


clear controllec, 


handlec 


sector wece all defecced until now 


get status 


if deceive noe selected, do it 


if not on right track, do it 


if head already loaded, no head loed dglay 


if nead un loaded, 


(continued) 


Se NR Se ee Re ee ES RT ce a RES mE ee ee - emg merngenpegeet weenie Scepeemnedtinete esareem Ieee a ES 
2 eee. 


jig eo fn SERRTS 


eeeat as new disk 


/ 


/ 
/ 
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195 newlrive: 
196 OG000LCE L3IFQDOOOOCCADOFPPPFC Move.b selcode,dentrlL ° select the drive 
197 00000106 L3r90000000G00000001 @ove.b seldcv,curdry 
198 Py newtrk: 
199 00000120 6126 bar chk seek * seek tO cocrect track if cequiced 
208 O00001E2 7604 aoveq $4,a3 © force nead toad delay 

oo 201 sexit: 
202 000001F4 13790000000400FFFFPA move.b saectoc,dsect * sec up sectoc number 
203 Q0Q00LEE 1L3P90000000200FFFFF9 move.b trackt,dtrk * set up track numsec 

uF 204 O0000LFS 207900000006 @ove.l daa,aQ © dma address to ad 

205 Q0000lFE 4275 cts 
206 
207 errcnk: 
208 00000200 asa70004 bese 04,d7 
209 00000204 6602 bane cnk seex * if cecord not found error, ceseek 
210 00000206 4275 ets 
211 
212 chk seek; 
213 : e check foc correct track, seek if necessacy 
214 00000208 615¢ oar teadid * find out wnat track we're on 
225 COQO0020A 67LE beq chksk * if cead id ok, skip cesctoce code 
216 testoce: 
217 ® home the dtive and ceseek to correct track 
218 0000020C Lircoooscorrrrrs @ove.d #$08,dcmd * cestore command ta command poce 
219 estwait: 
220 00000214 0839000700FFeFFC btst 47, dwait 


cep/a €#000 Assenmbieer Ravision 02.01 Page 5 

Source Pile: arergbios.s 2 

221 O000021C é6éeré dne rstwait * loop uncil cestoce completed 
222 00000212 0839000 200rFrrF8 best $2,dscac 

223 90000226 67£4 testoce * if noe ac track 0, try again 
224 00000228 4283 ele.l a3 * track numper ceturcned in d3 from ceadid 
228 enksl: 

226 0000022A 13c300FFPFF9 gove.b d3,dtrk * update track cegistec in FOC 
227 00000230 13°90000000200000003 gove.d track,oldtrk © update oldtrk 

228 0000023A 863900000002 cmp.b tcack,d3 * are we at cighe track? 

229 00000240 6722 beq chkdone © if yes, exit 

230 00000242 13990000000 200FFFrFrs gove.b track,ddata * else, puc desired track in data ceg of PDC 
231 0000024C L3rcooLsoorrrrrs g@ove.b $$18,dend bd and issue a seek command 
232 00000254 0839000700FFFFFC ehks2: bese 67, dwait 

~ 233 000002SC séré one cnks2 * loop until seek complete 
{ 234 00000252 16 3900FrFPFFS @ove.b dstat,d3 © cead status to clear FOC 
235 chkdone: 
~ 236 00000264 4675 ets 

237 

238 ceadid: 

239 : stead track id, cetucn track mumper in dj 

240 00000266 L3rcocc«corrrrra move.5d éSct,dcnd © issue ceed id command 

241 G000026e LE 3900FFFFFC move.b dwait,d? * wart foe intrg 

242 00000274 L63900rrPFrFrB @ove.b ddata,d3 © track byte to d3 

243 tid2: 

244 0000027A 0839000700¢FFFFC bese 67, dwait 

245 00000282 6708 beq estatus * wait foc inerg 

Listing Bel. (continued) 


od 
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00000284 
0000028A 


9000028C 
00000292 
00000296 


00000296 
0000029A 


00000 29¢ 
000002A2 


00000 2A4 
900002A6 


00000 2A8 
00000 2A5 
90000280 
00000282 
00000 2B4 
00000 236 


a | 68 
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ws Iscorrrrrs 
60eR 


ie3900rrrrrs 
02070099 
4575 


4280 
4875 


20 3C0000000C 
4875 


4B75 


4e75 


028 100cd00rFr 
e549 
2041 
2010 
2082 
4E75 


w~~~ ce File: a:ercgbios.s 


00000000 


00000000 
oogcdddlL 


90000002 
00000003 


00000004 
00000006 
Q000000A 
90000008 
do000c00c 


0000000E 
00000012 


Audi 


tr 
FP 


00 
00 


9000 
00000000 
oa 


QA 
oooL 


00900600 
00017C00 


ta formaticn 


weet ee eee ee ene ee ee ee ee 


Asseabdlec 


B Sample Assembly Language BIOS 
move.b ddata,d7 *® cead anothec byte 
bea eid2 * and loop 
estatuss 
aove.d dstat,d7 
andi.d $$9d,d7 © set condition codes 
ets 
f < 
flushs 
ele.t ® ceturn successful 
rts 
getseg: ; 
move.l $meargn,d0d * cetucn address of mea cegion table 
cts 
getios: 
ets 
setiod: 
ets 
setexc: 
andi.l é$€£,dlk @ da only for exceptions 0 - 285 
isi $2,dl * multiply exception nabec by 4 
@ovea.l dl1,ad0 
move.l (20),d0 ® ceturcn old vectoe value 
gove.l d2, (ad) * insect new vector 
noset: 


Revision 02.01 


data 
seldrv: .de.b - $&f * 
cuedev: .de.b see ° 
track: .de.d 9 = 
oidtrk: .d¢e.d t | e 
sector: .dc.w 0 
dma: deb @ 
selcode: .de.b 0 e 
ecrent: .de.b 10 
@eargn: .dc.w 1 
-de.l $400 
-de.l $17¢00 


© disk pacasetec headers 


Listing B-l. 


a@eive select code 


Page 6 


drive cequested by seldsk 
currently selected drive 


teack cequested by sectrk 
track we wece on 


* cetrcy counter 
* L memory cegion 


* seacts ac 409 hex 
* goes until 18000 nex 


(continued) 
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em ne me cme ween ee one 
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297 
2396 

299 

300 

3OL 

302 

ta 303 
304 

30S 
; ~ 306 
307 
: 308 
i 309 
’ 310 
: 31L 
312 

313 

314 

3 315 
316 

317 

318 

319 

320 

321 

322 

323 

) 324 
: 325 
326 

i 327 
H 328 


sete mes eared a 


329 
330 


00000016 
COOCOO1LA 
0000001C 
oo0godlEs 
00006020 
00000024 
00000028 
o090002C 


00000030 
00000034 
00000036 
00000038 
0000003A 
00000032 
00000042 
00000046 


QO00004A 
9000004C 
00000040 
000000 4E 
oocgoo4r 
00000050 
00000052 
90000054 
00000086 
00000058 


i ces“ 68 


Soucce File: a:ergbios.s 


331 
332 
333 


wn et lon abete twee. 208 we! 
ee es 
wu 
ee 


cal 
w 


‘ 347 


act 
DS 


semwetge we + eae ee = oes 


Q000005A 
000000S5E 
00000062 
00000066 
QCOQ006A 
9000006E 
00000072 


90000000 


90000000 


00000080 
99000090 


900000A0 


PCE PENT OT 
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O000G0SA 
oaae 
a000 
ao000 
900060000 
Q000004A 
go00ceaa 
0Q00000A0 


0OG00G5A 
9000 
goco 
0000 
00000000 
0000004A 
00000090 
oooaacce 


dphd: -de.b 9 xlt 
a) 


dew * dummy 

ede.w 80 

de.w Qo 

-de.l dicbuf °* ptr to directory buffec 

-de.L dpb © oer ta disk pacametec dlock 

-de.1 cxvd ® ptr to check vectoc 

-de.lk alvo © pee te allocation vector 
donl: .de.l = xlt 

-de.w §6@ dumay 

.dc.¥ 0 

dc.” 90 7 

-de.l dicbuf * ptr to directory buffer 

-de.l dpod * per to disk pacameterc Dlock 

del exvh ® ptr to check vectoc 

deol aivl ® ptr to allocation vector 


* disk parameter block 


dpor .dc.w 26 @ sectocs perc track 
.de.b 3 * plock shift 
-de.b 1 * dlock sask 
.de.d q @ extent mask 
.de.d 90 * dummy fi11 
.dce.w 242 * disk size 
-de.w 63 * 64 directory entries 
.dc.w $<000 @ dicectocy mask 
dc. 16 @ disectory check size 
-de.w 2 * erack offsec 


® sectoc translate tadle 


00a Asseamblec Revision 02.01 Page 1 


01070013 
19050811 
1703090F 
LS02060£ 
L4Lad60c 
L218040A 
1016 


xit: .de.d lL. 7,13,19 
-de.d 2, S,L1,17 - 
-de.b 23, 3, 9,15 
.de.d 2l. 2, 8,14 
.de.b 20,26, 6,12 
-de.b 18,24, 4,10 
-de.5 16,22 - 


bss 
diecbuf: .ds.o 128 ® directocy buffer 
oxvd: -ds.5 16 * check vector 


ekvl: .da.d 16 


alvd: -ds.0 32 @ allocation vector 


Listing B-l. (continued) 
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B Sample Assembly Language BIOS 


we/TA" VORA BYSCEM Vulge 


5S Sample Assembly Language BIOS 


3148 000000Cc0 alvl: -48.b 32 

349 

3180 900000890 
cr/n 686030900 Assenbier Revision 02.01 Page § 
Soucce File: aserqbios.s 
Syabol Fable 

cep eevevece Ext init oococede TEX? alwd OGOOCOCAG ASS = aivl 
Bicebase 0000001£ TEXT chkdone 00000264 TEXT chksl 0000022A TEXT ches2 
chk seek 00000208 TEXT ckvo > 00000080 ass oxvl 00000090 sss conin 
concuc QOOQOOAS TEXT conscat 00000080 TEXT curdrv 00000001 DATA dead 
denerl OOFFFFFC Aas ddata OOrFrP?PrSs ABs dirput 00000000 ass ama 
dpe 0000006A DATA dpnd Q0000G16 DATA dphl 00000030 DATA dpnlen 
dsect OOPFPFPA ABS dstat Oorrrrrs ass dtrk OOFFFFF9 ABS dwait 
ercronk 00000200 TEXT ercrcenet 0000000B DATA flush 00000298 TEXT getiob 
getseq 0000029C TEXT home 000000C8 TEXT iobase OOPFFFFs ABS lisese 
Latout OOO00OORC TEXT maxdax 00000002 Aas mearga GO00000C DATA newdr ive 
newtrk OOCOO1EO TEXT nfunes 00000017 ABS noset 00000286 TEXT noton 
olderk 90000003 DATA pun OOOCCOBE TEXT rcdone 00000144 TEXT cde 
cead GOOOOLIC TEXT readid 00000266 TEXT cecroe 0000014E TEXT restore 
cid2 0G00027A TEXT ¢c loop 90000132 TEXT cretry 00000126 TEXT estatus 
cstwait 00000214 TEXT sector 00000004 DATA sectran 00000108 TEX? seilcode 
seldrv 00000000 DATA seldsk 00000000 TEXT selrm QOGOCOOFE TEXT setdma 
setexc 00000 2A8 TEXT setiob 000002A6 TEXT setsec 00000100 Text sectrk 
setup Q000019C TEXT sexit QOO00LE4 TEXT track 00000002 DATA traphndl 
trapng 0000001C TEXT whooe OCO00007A TEXT wdone 00000184 TEXT vwerroe 
wloop 90000172 TEXT wretry 00000166 TEXT write QOGOOLSE TEXT xit 
2 
Listing B-l. (continued) 


End of Appendix B 


oooo00ce 
00000284 
00000094 
OOFrrrrs 
00000006 
O000001A 
OOF FFrrc 
00000 2A4 
000000C2 
ocecoice 
oco0c090 
ooo00cco 
00000 20C 
00000 28¢ 
0000000A 
00000114 
oooooors 
9000000E 
0000018£ 
000000SA 
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ee 2 ED 2 meee se ee ee ee eee oe oe 


Research 


eee ete tee cee 


ce oe ee thee ee 


8 ee we eer Boe + 


me re weer tbe oe 


en eres 


eae ns ces wwe 


cPp/n 


1 

2 

3 

‘4 

b 

6 

7 

8 

9 
10 
u 
12 
13 
14 
is 
16 
17 
18 
19 
20 
21 
22 
23 
24 
2s 
26 
27 
238 
23 
390 
31 
32 


33° 


. 34 
35 
36 
37 
38 
39 
4a 
41 
42 


Appendix C 


Sample Loader BIOS Written in Assembly Language 


00000000 
00000004 
00000006 
00000008 
Qo00c000c 


0000000E 


00000010 
00000014 
00000018 
0000001C 
00000020 
00000024 
00000028 
0000002 
00000030 


00000034 


00000038 
0900003¢ 
¢0000040 
cocooass 
oc000048 
agooogec 
00000050 
00000084 
00000058 
0000005 


68o0ga0 
Source Pile: a:eldbios.s 


0¢ 400017 
6caa 
£3548 
20780006 
4890 


4£75 


90000002 
0000000E 
0000006C 
00000080 
00000094 
00000002 
0o000ccE 
00000008 
oocogcas 
00000080 
aoacancs 
aooooocc 
ooocdozo 
Qooo0ddEs 
00000008 
a000000E 
00000004 
00000CE0 
00000002 
ooooc00r 


Assenmdblecr Revision 02.01 Page 1 


CES HESS SSSSHOS SESH SS HOS SHHSSASEHREKTESHSOSEHESHSSSHHAHESCHHORSEHTEOES 


2 

e CP/M-68K Loader Br0S e 
ss Basic Inpuc/Outpue Subsystes e 
° for ERG 68000 with Tacbell floppy disk controller e 
e e 
e e 


SHSHSHMSESHSSSSESOLSHSSSOSOSSHASTSEHSSSOSASSHSCSELEOSALeCsececaecaseseeese 


-globl _bios © declace external entry point 
bios: 
é empi tn tunes, dd 
oge nogood 
lsi #2,c0 © multiply bios function by 4 
movea.l 6 (pce, d0)},a0 * get handler address 
sc (a0) * call handlec 
nogoods 
ets 
biosbase: 
-de.. nogood 


Listing C-1. Sample BIOS Loader 
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SL -  -S  S TETE NE AONGERAE! -oe 


Ves VON Fystem vUulcE _ - C Sample Loader BIOS 


43 00000060 9000000R -de.l nogood 
44 90000064 0000000R -de.l nogeod 
43 00000068 00000222 -dew.l setexc 
“6 
47 néuncs=(*-diosdase) /4 
48 
49 : ‘ 
$0 O0000006C 103900FFFFOL cqnstat: move.b S£fff01.d0 * get status byte 
$1 00000072 02400002 : andi.w $2,400 * data available bit on? ‘ i 
$2 00000076 6704 beq noton * beanch if noe 
$3 90000078 7001 moveq.l 651,00 * set cesult cto true . 
$4 DOOOQCO7A 4875 ets 
$s 
cPp/*m 63000 Assenmbdleer Revision 02.01 Page 2 
Soucce Pile: a:eldbios.s 
$6 0000007C 4280 notons clr.l a0 * set cesult to false 
$7 Q000007E 4275 ets 
sa 
$9 00000080 61LEA conin: ose constat * see if cey pressed 
60 00000082 «AsO tse 40 
61 00000084 67PA beq conin * wait until key pressed 
62 00000086 103900FFFrO0 sove.b S££EL00,d0 © get key 
63 O000008C CoBCcOaccOCOTP and.1 e$7£,d0 * cleae all but low 7 bits 
64 00000092 4275 cts 
6s : 
66 00000094 103900FFFFO1 conout: aove.b S$ft££f01,d0 © get status 
67 0000009A CO3C0001 and.» = #S1,.d0 * check for transmitter buffer eapty . 
68 OOO0CO9E 6774 Seq conout « * wait until ouc port has aged... £ 
19 QOOOCOPGAD 13Cl00FFFFOO move.b dl,Sf£ft00 * and output it 
'2 GQO0000A6 4275 ets © and exit 
nl 
2 . 
73 ° 
74 * Disk Handlers for Tarbell 1793 floopy disk controller 
78 . e 
? maxdsk = 2 * this BIOS supports 2 floppy drives 
77 dphlen = 26 © Lengen of disk parameter header bd 
78 
79 iopase = SOCLELELS * Tarbell floppy disk port base address 
80 demd = iobase * output pore for command 
81 " dstae = iobase " input status port 
82 dtrk * iobaseel - * @isk track port 
83 dsect =» iobase+2 © disk sector port 4 
a4 ddata = _icbasee3 * dise data port : 
6s - dweit = iovaser¢ * input port to wait for op finisned ‘. 
pd dcntsl = iopasee4 * output control port for drive selection - 
a8 ° 
89 a0CCOOAs ¢23900000002 homes ele.B track 
90 GOQOCOAR 4875 cts 
91 
92 seldsk: 
e select disk A 
94 000000B0 423900000000 cls.d seldrv * select drive A 
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Cee TS Tee Ww Mis eT E> 


Mente. de Wer A Bde Se ae 


CP/M~68K System Guide 


109 


00200086 
0030008C 
000000C2 


9o00000c¢ 
QO00C0CA 


go0oaagocc 
90000002 


ooudoon4 
00000006 


42390000000A 
203¢0000000C 
4275 


13€100000002 
4875 


13€100000004 
4875 


2042 
48Cl 


10 90000008 10301000 
cCP/s 6 8 
Source Pile: a:eldbios.s 


di 
112 
113 
114 
115 
116 
127 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 


i. 136 


ee 137 


138 
139 
140 
141 
142 
143 
144 
145 
146 


Ali 


o00000DC 
00000002 


0o00000Ed 
ooo0o0es 


OOQOO0ES 


aooooore 
acogdor2 
ococoorsé 
o00000Fc 
00000104 
00000106 


Qg00 


asco 
4875 


23100000006 
4575 


13P¢000A00900008 


6134 
00430088 
LICIOOFFFFFS 


08390007 00FFFFrc 


6708 
LOFPIOOCFFFFFS 
134 


Q0o0e10C 66 


0000010E 
00000112 
00000114 
00000116 
00000118 
COOCG1LLA 
90000126 
00000122 
00000124 


00000126 
00000128 


61000106 
6604 

4280 

4275- 
6170—C- 
5339000000038 
66CE 


10°F 
4575 


L3rcocoooorrrrrs 


163900000001 


seletn: 


settrk: 


setsec: 


sectran: 
e 


Assemblec 


setdma: 


tead: 


C Sample Loader BIOS 


ele.b selcode ® select code is 00 for dev 0, $10 foe dev i 
move.l j§dpnd,dd 

cts 

move.S dl,crack 

cts 

move.b dl,sector 

ets 


teanslacte sector in dl with transiace taole pointed to by d2 
cesule in dO 

movea.l d2,a0 

ext.l dl 

move.b 40(a0,d1),d0 


Revision 02.01 Page 3 


ext. 1 40 
ets 


move.l di,dma 
cts 


© Read one sector from cequested disk, track, sector to dma address 


* Retry 


cretry: 


cloop: 


cdone: 


cerroc: 


setup: 


if necessary, cetucn in dO 00 if ok, else non-zero 


move.b $10,eercnt ® set up cetry counter 

oar setup 

eck #$88,a3 * OR cead command with head load bit 
aove.b d3,demd * outpue it to Foc 

bese 67, dwait 

beq tdone © if end of read, exit 

move.b ddata,(al)> © else, move next byte of data 

dra cloop 

bse estacus * geet FOC status 

bne cecror 

ele. &@ 

ets 5 J 
bse errchk * go to erroe handler 

subq.5 bl,errent 

bne eretry 

move.l #Stftfttete,dd 

cts 


* common cead and write setup code 
* select disk, set track, set sector were all deferred until now 


Listing C-l. 


move.b @$d0,dcnd 


* cleac controllec, get status 
gove.b cusdrv,d3 


(continaed) 
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C Sample Loader BIOS 


wes Fav VY ZYousm VYULUSG 


147 90000134 863900000000 cmp.d seldrv,d3 

148 COCOOLIA 661A dane newds ive “ Lf drive not selected, do ie 

149 0000013C 1639000009002 gove.b tracx,d3 

130 00000142 863900000003 cnp.b older, d3 

151 00000148 6626 bone newtrk * ££ noe on right track, do ie 

352 O0000L4A 4283 ele.l 43 ® 1£ head already loaded, no need icad delay 
153 Qo0001eC O839000SOORFrFrs bese ¢S,dstac * {€ nead unloaded, treat as new disk 
15400000154 6618 ,one sexit + 

185 newicives 

156 00000156 LiF9OoCOOOOAOOrFFYYC move.b selcode,dentrl °* select the drive 


137 90000160 LirscacaococooOO‘ONL move.b seldev,curdrv 


188 newtrks . 

189 GOOO01G6GA 6126 bar chk seek * seek to corcect track if required 

160 Q0000LEC 7604 moveq $4,083 * force head load delay 

161 < sexits 

162 00000168 13F90000000400FFFrPA move.5 sector, dsect * set up sector numer 

163 00000178 13790000000 200FrFPFFF9 move.b track,dtrk * set up track number 

164 00000182 207900000006 move.l dma,a0 * dma address to a0 

165 00000188 14875 res 
cps 68000 Assenmbdblee Revision 02.01 Page 4 

Source Pile: areldbios.s 

166 . 

167 ecechks 

168 9000018A 0807beG4 bese $4,da7 

169 00000188 6662 bne chk seek * if cecord not found error, ceseek 

170 90000190 «B75 ets 

72 

172 chk seek: 

17° id check for correct track, seek if necessary 

y) 10192 618¢ ose ceadid * find out what track we'ce on 

uu (0194 6718 beq ehksl * ££ read id ox, skip restore code £ 

ul cestore: 

ye ° home the drive and reseek to correct track 

ve 00000196 L3FcOOcaOOPFrrrs move.b $08, dcnd * testorce command to command port 

cstwait: 

180 00000192 0839000700PPFFFYC best #7, dwaie 

181 OOGCOO1AG S6F6 one cstwait * loop until restore completed 

182 000001A8 0839000200FFFPrFa bese #2,dstac 

183 000001B0 6724 beq restore * ££ not at track 0, try again 

He 90000182 4283 ele.l 43 * track number ceturned in d3 from readid 

1 chksls 

186 00000184 L3ICI0OPFFPPS move.b d3,dtrk * update track cegister in FOC 

187 0000018A 13F900000002000G0003 move.b track,oldtrk * update oldtrs 7 
188 000001C4 863900000002 cmp. track,d3 * ace we at right track? < 
189 O0Q001CA 6722 beq chkdone © if yes, exit ‘. 
190 Q00001cC 13F790000000200FFFFrrYA move.b track, ddata * else, put desired track in data ceg of FDC ; 
191 600001D6 L3FcoolscOrFrrrra aove.5 18, e and issue a seek command i 
192 000001DEB 08390007 00PFFFrC chks2s btst $7,dwaic : . 
193 Q0000 LES. 66R6 bre cnrs2 * loop until seek complete 

194 OOOOGLES 163900FFPFPE gove.b dstat,d3 * cead status to clear FDC 

195 chkdones 

136 QOOCOOLER 4E75 ets 

197 

198 ceadid: 

Listing C-l. (continued) 
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nese ete ow 


ne kee Ambo manele eed a heme an te. othe ABR oe etermeee we 


See anes ete ethentatamee anh sha - 


aot e-eelee - 


= 


oe. oe 


soe” 


wes eh VEN wyoucm GUuUsuGc 


199 
200 
201 
202 
203 
204 
20$ 
206 
207 
208 
209 
210 
211 
212 
213 
224 
215 
216 
217 
218 
219 
220 


qoqcoo ire 
ooo0olrs 
00000l1FzZ 


00000204 
9000020C 
00000202 
00000214 


00000216 
0000021C 
00000220 


00000222 
90000228 
0000022A 
09000022¢C 
90000228 
000002390 


cps 68 
Source Pile: 


00000000 


00000000 
00000001 


90000002 
00000003 


oooo000s 
00000006 
Q000000A 


00000008 


goc0c00e 
00000010 
090000012 
00000014 
90000016 
OO00001A 
000000 lz 
00000022 


Lircooc 400rrrrrs 
2Z3900FFPPPC 
163900FPFrYB 


0839000700FrFFFrc 
6708 

LE JSOOFFFRPB 
§0ZE 


1£3900rFPrFrs 
020700990 
4B75 


028 1000000FF 
e549 
2041 
2018 
2082 
4E75 
o00 


rr 
rr 


0000 
00000000 
ao 


GA 


00000036 
6000 
0900 
0000 
00000000 
000006 26 
oococ000 
ooo00000 


Assenmdlec 
aselddios.s 


— caumpie Loader siU05 


e read track id, ceturcn track number in 43 
move.b §$c¢.dcad © issue read id command 
move.d dwait,d? © wait for inerq 
move.d ddata,d3 © track vyte ta 63 
cid2: 
bese 07, dwaie 
beq estatus @ wait fore intrq 
move.b ddata,d7 * cead anotnec byte 
dea cid2 © and iocop 
cstactuss 
move.d dstat,d7 
andt.b #$94,d7 © set condition codes 
ets 
setexe: 
andi.l ¢Sff,dl *® do only for exceptions 0 - 255 
1sl 62,42 * multiply exception numper Sy 4 
movea.l d1,ad 
move.l (a0),d0 ® ceturn old vector value 
move.l 42, (ad) © insert new vector 
cts 


data 


seldrv: 
curcdev: 


track: 
oldterks: 


-de.w 
deol 


sector: 
dmas 


.de.b 
idewb 
de. b 
tde.b 


Revision 02.01 


9 
t] 


selcode: .de.b 0 


ecrcnt: 


-d6.b 


10 


© disk parameter headers 


-da.1 
ode. 
-dc.w 
-de.w 
-d6.1 
del 
-de.l 
deol 


dpnds 


Page s 


drive cequested by seldsk 
* cuccently selected deceive 


track requested by settrk 
* track we were on 


* deceive select code 


* cetry counter 


alt 

Q . © duaey 

t 

Q 

diebuf °* per to directory buffer 

dpo * per to disk pacameterc block 

ty * per to check vector 7 
0 e 


° disk parameter block 


Listing C-l. 


per to allocation vector 


(continued) 
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Se ee nee ee ee ore SE NEE me 


CP/M~68K System Guide C sample Loacer siuD 
251 
2$2 00000026 COLA apos -dc.w 26 ® sectors per track 
283 00000028 63 -é¢.3 3° * plock snift 
254 00000029 07 .de.5 7 * block mask 
255 0000002A 00 ded 9 © extent sask 
256 90000028 00 -de.8 9 © dummy fill 
287 9000002C OOF2 ac. 242 @ disk size 
2$8 0000002 OCiFr t -de.w 63 © 64 directory entries 
259 00000030 C000 dc. $c000 * dicectory task - 
260 00000032 0010 dc. 16 * dicectory check size 
261 00000034 0002 -deww 2 * trace offset 
262 
263 * sector translate table 
264 
265 00000036 01070013 xLe: .de.d Ll, 7,33,19 
266 0000003A 19050811 .de.b 28, $.11,17 
267 00000032 1703090 .de.b 23, 3, 9,15 
268 00000042 15020808 de. 21, 2, 8,34 
269 00000046 141A060C .de.d 20,26, 6,12 
270 QOQOOO4A 1219040A .de.d 18,24, 4,19 
271 90000048 1016 -de.b 16,22 
272 
273 
274 00000006 bas 
275 
cCPpsn €3000 Azssenmbdiec Revision 02.01 Page 6 
Source File: a:eldbios.s 
276 90000000 digbuf: .ds.b 128 * disectory buffer 
17 
78 
79 000000860 end 
cP/m" 63000 Assembler Revision 02.01 Page 7 
Source File: a:eldbios.s 
Symbdol Table 
dios 00000000 TEXT biosbase 00000010 TEXT chkdone  dOQOOlEE TEXT chksi 000001B4 TEXT 
chks2 000001DE TEXT chkseek 00000192 TEXT conin 00000080 TEXT conout 00000094 TEXT 
constat O000006C TEXT curdrv 00000001 DATA demd OOFFFFFS ABS denerl OOFFFPFC ABS 
ddata OOFFFFFS ABS) dirbut 00000000 BSS dma 00000006 DATA dpb 00000026 DATA 
denod 0000000C DATA donien OOOOCOC1A ABS 8 dsect OQOPFFFFA ABS dstat’ OOFFFFFS ABS 
dtrck Oorrrrr? ABS dwait OOFFPFFFC ABS) errcchk QGOOOLSA TEXT errcnt 00000008 DATA 
home QOOOO0AS TEXT iobase OOFFFPFS ASS maxdsk 00000002 ABS) = newdrive 00000186 TEXT - 
newerk OOO001EA TEXT nfuncs 00000017 ABS ndyood G0O000008 TEXT noton eqcooo7c TEx? ‘ 
oidtgk 00000003 DATA rcdone 0000010B TEXT cead QO0000ES TEXT rceadid 000001FO TEXT = 
cercoe 00000118 TEXT cestore 00000196 TEXT cid2 00000204 TEXT cloop ooocccre Text : 
cretry QCOdCOFG T2xT rcstacus 00000216 TEXT cstwait OQ0C019E TEXT sector 00000004 DATA . 
sectran 00000004 TEXT selcode 0060000A DATA. seldrv 00000000 DATA seldsk 20000080 TEXT 
selrm 000000C2 TEXT setdma OOCOOCEO TEXT setexc 00000222 TEXT setsec oQocooccc TEXT 
Seterk ~*~ 0600000C4 TEXT setup 00000126 TEXT sexit 0000016E TEXT track 00000002 DATA 
xlt 00000036 DATA 
Listing C-l1. (continued) 
End of Appendix C 
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Appendix D 
EXORmacs BIOS Written in C 


This Appendix contains several files in addition to the c 
BIOS proper. First, the C BIOS includes conditional compilation to 
make it into either a loader BIOS or a normal BIOS, and there is an 
include file for each possibility. One of these include files 
should be renamed BIOSTYPE.H before compiling the BIOS. The choice 
of which file is used as BIOSTYPE.H determines whether a normal or 
loader BIOS is compiled. Both the normal and the loader BIOSes need 


‘assembly language interfaces, and they are not the same. Both 


assembly interface modules are given. Pinally, there is an include 
file that defines some standard variable types. 


810$S.¢ 


This is che main text of the c language S108 for the ExORmaecs. 


ll oa eat ete men emmmmere cen nee ecw ene e/ 
7? : A 
7s| CP?/M-68K(tm) 310S for the ExOaMacs . ley 
fe . j°/ 
7* Copyrignt 1982, Digital Research. \°7 
ee WA 
/* Modified 9/ 7/82 woe ley 
/* 10/ 5/82 woe * ley 
/e 12/18/82 woe . */ 
/* 12/22/82 woe : °/ 
/e ; ey - 


binclude “biostype.n® /* defines LOADER : Qe> nocsal dios, 1->loader bios *7 
/* also defines CTLTYPE 0 <> Gniversal Disk Cnerlr */ 
fe 1 -> Floppy Disk Concroller “/ 


include “biostyps.h* /* defines poctable variable types °/ 
Chae copyright{) = “Copyright 1982, Digital Reseaccn®; 
struct mesb { aYTE byte: |; /* use foe peeking and poking memory */ 


struct menw } WORD word: | 
struct meal LONG lwoed;: }; 


Fee ee cer rea sseuseeeesceseaccececescosconcoeseescessesececescosee/ 
7e T/O Device Definitions */ 
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tdefine NAK OxLlS 

tdetine PXTSTX 0x0 /* offsets within a disk packet °/ 
pdefine PKTIO Oxl 

tdefine PKTSZ Qx2 

§deline 2KTOEV Ox3 

tdefine PRTCHCOM Oxé 

tdefine PKTSTCOM Qx$ : 

tdefine PRTSTVAL Ox6 ‘; : . . 
(define PRTSTPRM 0x8 : : 
tdefine STPKTSZ Oxt 

[POSH SOTHOO SER ECOSEOERESOSE OATES OT OEHSLELES SESE TEES SOUL AEH ETESORAHOSEETOe/ 
/* BI10S Table Sefinitions °/ 


[ POCO SHH OS TEDECEEAAOT EHO OESETOL OAH OSSOSS OS OUD ESOS HTESHOOTELTEOTOTESOSEEa/ = 


7* Oisk Pacapeter Block Structuce °/ 


tone dpb 
WORD Spt; 
BYTE bshy: 
BYTE Dias 
S8YTZ exE; 
8YTE dpbjunk: 
wORD deny 
WORD dens 
BYTE alds 
BYTE all; ‘ 
WORD cocks: ‘ 


WORD off; 
}; 
/* Disk Parameter Header Structure */ 
. for dph 
3aYTEe *xltp: 
WORD dphser (3); 
BYTE *dirputp; 
struct dpd *dpbps 


BYTE  *alvps “) 
' ye 


-., 


[ TEPER OD OHS BHATLODS LS OOHLH OHNE HER OSHS EDABAEROVAER PSH OUSHHEOHEOOTHATAEEE/ 


/e Dicectory Suffer foe use by the 80S */ 
[POS OLEMED HCE TR SAREDON ETE CHEATS ALLO SEOTS SELES OATHS OD TUESSCOTEEEHOLESETT/ 


BYTE dirbul(128]3 
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[CPOMP OSE LEME DEES ELEOS DESL OELLCETETELESES DETER LO LOE HORE LON REELED ETOCLES/ 
fe? Ccsv‘s */ 


[OTOP eM eereceeeses anes eeuerereenerreeeTeesessterecareaearneneTeseereeeee/ 


8YTE esv0(1él; 
BYTE csvl[lé6l; 
8YTE esv2( 256]; 
BYTE esv3(286j; 


[POOR MOC e rarer ereersecscerreceeerecereearesteneoveneerereneeaeseseneeee/ 

f* ALV‘s es 

[PPCM ORE CORSO ee HELO LaETE TENET ECE U OEE EET HEE TOT E LEST OOREOETETSeOReeCeTTe/ 
e 


ayTe alv0(32}; 7* (desma / 3) © 2) °/ 
aYTe albvl(32]; 7* (dsol / 8} e+ 1 */ 
arte alv2(412); /* (asm2 / 4) © 1 °/ 
BYTE aiv3(412}3 7* (dem2 / 8) o 1 °/ 
tendit 


[PTCA H OAC ORE C LOLOL CEST TATED ETOH HUTS OOS LUTTE TELCO TE LCE REROCTELETOETE/ 


/* Oisk Parameter Blocks e/ 
[OPC Ae HeereCee eT eee eee eTe Nese COOTETE TOO EE HO EL EEE ETE TELONETEHOETENEEE/ 


/* The following dpb definitions express the intene of the weiter, es 
/* unfortunately, due to a compiler bug, these lines cannot be used. e/ 
/* Therefore, the opscure code following thee has been inserted. e/ 
[tteacceevecee spe, dsh, dla, exm, jnk, dsm, dem, 210, all, ckxs, off 


struct dpo gabon 2%. 3, %%, OO, 0, 242, 63, Oxco, 0, ‘16, 2}: 
struct dpb dpbd={ 32, 5S, 31, lL, 0, 3288, 1023, OxeP, 0, 256, 4}; 


eveenreren end of teadable definitions eeccersvereras/ 


/* The Alcyon C compiler assumes all structures ace arrays of int, s0 «/ 
/* wn the following definitions, adjacent pairs of chacs nave been e/ 
/* combined into int constants —- what a kludge! eeoreneronerearavereet/ 


struct dpb dpbd = { 26, 775, OO, 242, 63, -16384, 16, 2 {3 
struct dpb dop2 = 32, L311,.256, 3288, 1023, OxFFOC, 256, 4 }; 


[Pteeeeeneccvces End of kludge **eececencesereees 


/ COPRON Case aeeeeTareLaLeaeaeLoLLELeLLeCELeHeCTeeLeLENeCUSEEHTeLECNOCTeETE/ 
7* Sectoe Translate Table for Floppy Disks */ 


[AOAC OR COMO TO HOLTER OTSELERECEOOTEL ETE SOC ESET LETT OTORUOOTHHESDECRLENRCCE/ 


SYTE xle(26} = { 1. 7, 13, 19, 28, 5S, Ll, 17, 23. 3e 9, 18, 22 
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2, @, 14, 20, 26, 6, 12, 18, 24, 4, 10, 26, 22 }s 


[PCCCOHHHTOL ESOS OODLE LESLE TEL CU ESET EL ELT CENT OMEN ELON ES VACA ICCS ELITE NTO Tees 


/* Disk Pacametec Readers e/ 
7e PY °/ 
7® Four disks ace defined : dsk a: Hisxnos0, (Motorola's #£d04) °/ e 
7e ask 9: disknoel, (Motorola's #£d05) °/ . 
7e dsk ¢: disxno=#2, (Motorola's #hd00) s/ 
fe dsx d: disxnos}, :Motorola’s #nd0l) ff 


[ TUCCHOASCHOE EHO OH HCOCOHO TELE ESO O TENSOR OTE OEE HOTESSOOSEESEH TANTO HECEL/ 
oif ! LOADER 
/* Sisk Pacametec Headecs */ 


struct doh dphtab(4] = 
‘exit, 0, 0, 0, sdirbuf, Sdpbd, &csv0, salvo}, /*dsk a*/ 
exile, 0, 0, 0, sdirbuf, sdppd, acsvl, saivl}, /*dsk 5*/ 
OL, 0, 0, 0, sdirout, &dpo2, &esv2, salv2}, /*dsk c*/ 
| OL, 0, 0, 0, sdicbuf, sdpd2, sesv3, Salv3j, /*dsk 3*/ 
it 
telse 
struct dph dpntab(4] « 
{ jexde, 0, 0. 0, sdirduft, &dpod, OL, OL}, /*dsk at/ 
szlt, 0, 0, 0, sdicbuf, sdpod, OL. OL}, /*dsk o*/ 
Qu, 0, 0, 0, sdirbuf, sdpb2, OL, OL}, /*dsk c*/ 
} OL, G, 0, 0, sdirduf, &dpb2, OLe OL}, /*4sn a*/ 
endif : 


[ POCOS HOHE HECHT EDEOOEE ATED EES ELE THOS SHEOTTS ESOS UTES TOSHSTHEN EE SSEREEHEe/ 


/* Memory Region Table : «/ 


[ PRCOMOSEHTE TORT RESOEEHOREE RECENT ETEHE SLORY TE OHEEHTUHOSELEHOSSENSCERERON/ 
struct art ( WORD counts 

LONG tpalows 

LONG tpalens 


I 
memtab = { 1, 0x0400L, Oxl4cdOR }s 


tif | LOADER 7 ‘ ») 


[PP PO MAO SHEET EEORACLETE TOROS TENTS OLOELOTOTENIOHOEHOLHEOLELEESIOCEHTEEEH/ 
/* TOBYTE e/ 


[ POPOCOE OO AEOTSSEE SOAS HDTRESS OSORES LESS OCTET OTE LAHTOELSSHONTLOSOSELONOEOR / 


WORD iobyce: /* The I/O Byte is defined, but not used */ 
tendif 
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[OO PeRseeneueceseceneeseceeneocoucuneeresseseseruleeeeneeeereerraeerenees/ 


f°? Cucrently Selected O:sk Stuff es 


a A tg 


WORD settrk, setsec, setdsk: /* Cuccenely set track, sector, disk */ 
BYTE *setdma; /* Cuscently set dma address °/ 
“oo 
LPCERCC USO SEA We LOL DECED ELS OE CRETE TELE TEL ONTO CL ON SEE SHU Tee DEE CLES CLETEEe/ 
* Teack Buffering Definitions and Varciaoles °/ 
[Cow eweenrrerseuresessceuaareereree seers el eee telseeeTeeE ee aesTereeeesee/ 
#it ! WADER 
tdefine NUMTS 4 /* Number of track buffecs -- aust de at least 3} e/ 
7° foe the algoc:ienms in this BIOS to work proper ly A 
/* Define tne crack buffer stcuctuce °/ 
struct tbser [ 
struct tdstr ‘*nextoué; 7* focm linked lise for Lag ¢/ 
arte duf{[32°228); /* big enough for 1/4 nd erk */ 
#ORD ask; /* disk foe this buffer *%/ 
@ORD trk: /* track for this buffer °/ 
BYTE valid; /* puffer valid flag / 
BYTE dictys /* true if a BIOS write has os 
/* put data in this buffer, / 
/* but the buffer hasn't deen */ 
} /* flushed yee. / 
struct tostr *firstbuf; /* head of linked list of track buffers */ ° 
struct tbstr "lastbuf; /* tail of ditto */ 
struct thstr tbuf(NUMTBI; /* array of track duffers */ 
telse 
/* the loader bios uses only Ll track ouffec */ 
BYTE bufltrk(32°1281; /* big enough for L/4 hd trk */ 
BYTE voufvalid; 
as WORD buftrk: : 
\. . tendi£ 


[Oe eewes saveverrensuearessanccceneeoseseenreseserseoeneneeeeoreeeooretett/ 
7* Disk I/O Packets for the UDC and other Disk £/0 Variables °/ 


J CCCP CCNA oerensonoeceaeenTenTereoRreLToveseLererTeesecerovorCreENeneneT/ 


/* Home disk packet */ 
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LLL AS ey ES eng! - eee: wee 


struct hapese [ 


avtTe al; 

aYTZz a2: 

BYTE ads 

BYTE daknos 

SYTE coal; 

BYTE com2; 

BYTE a6: “ 

} axte al; ' 
nepack = { 512, 1792, 0, 768 }; /* kludge init by words */ 


/* Read/wricte disk gacket °/ 


struet cwoxse [( 

SYTE stxche: 
8YTE pktids 
aYTE pktsize; 
BYTE dskno; 
BYTE cheomds 
BYTE devemds 
wORD numblks; 
WORD olksizer: 
LONG iont; 
#ORD cksum3 
Le lsect; 
BYTE etxene?: 

} BYTE cwpad: 

; 


& ewpkse cwpack = { 512, 3376, 4097, 13, 256, 0, 0, 0, 0, 0, 768 js 
ese ‘ LOADER 
/7* formac disk packet */ 


Struct fatpxst { 
aYtz fmtstx?: © 
BYTE fmeid: 
arte fmtsizes 
3YTE Emtdskno; 


SYTE fatehemds . 

SYTE fatdvemd: : . s 

aYTEz fmtetx: Fy 

BYTES tmepad; .. 

bs. 
struct fmtpkst fmepack * { 512, 1792, 0x4002,-0x0300 }; ~~ 


tendit 


SPOCCROTE DOS REO AT EHOT EET HR ORS OLEHOS SE HOTOH ES ELOOTOOHOOHAOSHDADOUETELEHEE/ 


/e Define the number of disks supported and other disk stuff */ 
[OPO OT HEROD AHOAH ORDER ERHEE SOO EHS SOUTSCHLHOSOOEES SELES OTSOSETEEHEROCTHLOR/ 
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Pee ee 


+ Pee eee ce eee ee tee ee mee 


t+ Bee ee eee 


Te ce Oe ee Sine ee Se a te tm ene 


ene eee ere eee 


~~ ee wwe we zyweuss VULUS 


Ur reece teeeseececeseeneacesseseccsceeceeasenseeseeceeeceeetsseseseeees/ 

7e Genecie serial pore input e/ 

fee eee ree eee ee tee wen e ee ee eeneseceeeeeeelotteeeeeneeooeseeeseeeeseeee/ 
“é 


SYTEZE portin(pore) 
a BYTE *pece; 


while ( ! poetstat(pores) ; /* wait for inpue °/ 
cetucn ( *(port * PORTROR)); /* got some, cetucn it °%/ 


Heese esas asenneesseroveveneesereccceeoneeeecoeceeseeeesseeeeeseeoee/ 


7 Genecie serial port ourput “/ 
(eeewweeeeeeseeeeeeereesuananererereeseooreoesesTeseeoeereoeresereeseeees 


Pportout(poret, ch) 
REG BYTE *poee; 
REG BYTE ch: 

( 


Hare eereeceeceseseesccesevevesecoveessececnseceescoenrececeeseereooereree/ 


/* Ereoe peoceduce for 3108S e/ 
J ooreeeeereeseseessseuseeaeerseseneseneevonseseceenseseesoeeeeoeoeeeeeeee/ 


¢1€ ! LOADER Z 
biosecr(errnsg) 
SYTEZ *errnsg; 


Pcineste(“ncBlOS ERROR -= °); 
pein tstrclercrusg) 3 
erintserc(*.arc*); 


} 


peinetstr(s) /* used by dioserr ¢/ 
ra aYTE *s; 


while (*s) [poctouc(PORTL,*s); s += 1; }; 


belse 

dioserr() /* minimal ecror procedure for loader BIOS */ 
lL: gow 2; 

} 

tendit 


Listing D-l. (continued) 


while ( ! (*(port + PORTSTAT) 6 PORTTDRE) ) ; /* wait for ok to send */ 
} "(port + PORTTDR) = chy /* then send character e/ 
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[PSS OS OCHA OS ERE HOSS OECSO ESTES SEES EEHTOOHOLOSOCOSESOESES SES IOETEESESESTTE/ 


se “7 


{ PCCSEOSESHSEHOTOCTEHOC OTST ESE SOTEESOSESSS SES ACOS HOES SETTEOO SEES LEBEEHEES/ 


EXTERN dskia(): /7* extecnal intecrupt handler -- calls dskic ef 
EXTERN setimask(}; 7* use to set inteccupt mask -— ceturns Old rask e/ 
. . 
dskie() . : ) 
/7* Disk interrupt Randler -- ¢ Language Portion */ . bs 


REG BYTE workbyte; 
aYTze stpxe(STPKTSZ]: 


workbyte © (OSKIPC + ACKFMI PC) -> bytes 


if ( (workbyte == ACK) || (workbyte =# NAK) ) 
if ( ipestate «= ACTIVE ) intcount «= 1; 
else (DSKI2C + ACKFMIPC}->byte = 03 /* 222 */ 
workbyte © (OSKIPC + MSGEMIPC)->byte: - 


if ( workbyte & ax60 ) 

{ getstpke(stpkt); , 7 
if ( stpxc(aXTID] == OxFF ) 
; /* unsolicited ¢/ 


unsolst(stpkt); 
sendack()3 


} 
eo 
/* solicited */ 
if ( ipestate == ACTIVE ) intcount += 1; 
} else sendack(); 
} . 
} /* end of dskic °/ Bs : ) 
[ ROSS CAH SE RAAEEOS EHD EO EHS COU OCE LOD OHEOESETODT ESATA MORES HOORHEDOTESEETETES/ 
/* Read status packet from [PC °/ 


[ MECH SCARE OES OE SHEETS SOHHNSS DE SER OT SESH PEE UOT OTOS HOSES OTHHOETHOTETEROESO/ 


getsetpkt(stpk ep) 
rea SYTE *stpxkeps 


REG BYTE *p, *q3 
REG WORD i; 
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Pp» Stoktp; 
q@ * {DSKIPC © PKTEFMIPC); 


(OnE E At Seaeesas bak eA 


*p a *q; 
P +* 1; 


— q +2 23 
} 


Hg re een een evescesesereecocesseeeneseceeoeeeeeeseeetecereesscenseeesoeee/ 


7° Handle Unsolicited Stacus from IPC °/ 
ate T TTT TTT Ty, 


unsolse(stoeep) 
ae BYTE “stpxep; 


REG WORD dev; 
REG WORD ceady: 
REG struct dsxst *dsp; 


dev = ccnvds«x( (Stpk tpePKTDEV) =>byce |; 
ceady © ((stpktp+PKTSTPRM}=>byte & 0x80) e= 0x0; 
dsp * 6 dskstace{ dev}; 
af ( ( ceady 6& !(dsp->ready) ) tH] 
(tready) te (dsp->ready) ) dsp->change = 1; 
dsp->ceady » ceady; 
@if | LOADER 
, 1£ ( ! ceady } setinvld(dew); /* Disk is not ceady, mack buffers */ 
endif . 


@if ! LOADER 


feee PMeatreneereterzaveseenee Cennerenrerrevenerecreeoneceee seceecerverereoe ees 


/e Mack all buffers for a disk ag not valid “/ 


[Pee ee derccncvccrveesererenccesucrcseeceneecere tereectenreceoereneeren ovress 


setinvld(dsx) 

REG WORD dak; °. 
e- > 
] : REG struct tbhser *tbp: 
ore ebp = ficstbuf; 


co ( tbe } 


Lf ( thp-odsk es dsk ) tbp=>valid = 0; 
thp = thp->nexecbuf; 


tendif 
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= ww weaweGws Daa 


iopackp © (OSKI PC +PKTTOr PC} ; 

do [*iopackp = *pktadres: iopackp + 2; pktsize -« 1;] wile(pktsize); 
(OSKE PC +MSGTOI PC) <-> byte © 0x60; 

imsave * setimase (7); 

dskstace(actvdski.state = ACTIVE; 

ipestate = ACTIVE; 

inccoune = OL; $ 
(OSKIPCINTTOLPC)->byte = 0; 

setimask( iesave); ! 


} wartack(); ; ) 


[eee eee waeeereeeeaenaseLeeTeneseeErereserersereseN ee eeeeneETErereTeCe leet, 


t ded Wait for a Disk Operation to Pinish */ 
[OOOO Ce aweeeeeeeeeereueeersseerenEL rere RET OTERET TET DE LOT ELECISEEHELEEE/ 


WORD dskweit(dsk, stcom, stval) 
REG WORD dsk; 


BYTE stcoms 
ie stval; 


ASG WORD imsave; 
BYTE stpkt(STPKTSZ]; 


imsave = setimask(7); 


while ( (! intcoune) 66 
{ dskstate(dsk] .c0aady && (! dsxstate(dskj .change) } 


} 


if ( intcoune ) 


Setimask(imsave); .msave = setimask(7); 


intcount <= 1; 
a ( ( (OSKIPC + MSGIMTPC)=->byte & 0x80 ) == 0x80 ) 
getstpkt(stpkt); 
setimask(imsave); 
if ( (stpke{PKTSTCOM] © stcom) 6& 
( (Stpkt+PKTSTVAL)<>word =2 stval ) ) ceturn (1); 
} else : ceturn (0); 


Setimask ( imsave) ; 


} cetucn (0) - : £ ) 


Lover ceveccouerescerverseresroncenaveccceressesoveveowscoerestoseooeeeees/ 


7* Do a Disk Read of Write °/ 
[eras seoeevacoveereveevensseuvecrveesevecewsrouoroeoerensrecoerseseoeesee/ 


Gskxfer(dsx, trk, bufp, cmd) 
REG WORD dak, trk, cad; 
C BYTE *bu fp; 
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/* build packet */ 


REG WORD sececnt; 
REG WORD cesult: 


@ie Ctutrpe 
LONG bytecats /* only needed foe FDC */ 
WORD chek suns 

bendif£ 


twpack.dskne = cnvdsk(dskj; 
twpact.iogt = tutps 

sectent = (dphtad(dsk] .dpbp) ->spe; 
twpack.lsect = trk * (sectene >> 1); 
cwpack.chemd = cmd; 

ewpack.numblks = (sectene >> 1); 


eif CTLTyPe 
cheksuam @ 0; /* FOC needs checksum */ 
bytecnt = ((LONG) sectent) << 7; 
while ( dDytecnt=-- ) cheksum ee (“(*bufpes)) & Oxtf; 
ewpack.cksum = cheksua; : 

tendit 


actvdsk = dak; 
dskstate(dsk}.change = 0; 
Sendpkt(&ewpack, 21); 

cesult © dskwaie(dsk, 0x70, Ox0); 
sendack(); 

dskstace(dsk].state = IDLE: 
1pestate = [DLE;° . 
tetucn (result) ; 


#i¢€ | LOADER 


[AVOCA O LCR TeReeOseCDEOLELEHLDLERULEL ESTO L LEC SHROTENE TELL OTEEEEERTETET/ 


7? Weite one disk buffer °/ 
[eee wowaaaareeeeseeerceenTereeLeoeteseToesoEHeerrereTeLeEETelereNNenTeTe/ 


Clushl(tbdp) 
Claas © thste *tpps 


REG WORD ok; 
if ( thp--walid && tbp=>dirty ) : 


OR = dskxfec(thp=>dsk, tbp=>trk, thp=->buf, DSKWRITE); 
else ok = 1; ‘ 


thp-r-diecty = 0: /* ewen if ecroc, mack not dirty */ 
thp->valid se on; /* otherwise system has trouble */ 
7* continuing. of . 


cetucn(on) s 
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> _ —eoWowsthtess if be Wa 


[OTe e CeO ABA A TOO e LOCC LEON TALES ELESS EO TOSSOCUE SORTASE SEEOEDONELE SELECT CEE/ 


7 Weitte all disk buffe es 


LOMO See ewa Tee eReTaLeeweTIET ES ELL HOMES EE LOSOE LETS SURE OEHENEHESELEEDECTOEs 


oe 


RBG struct ebstr *tbp: iad ® 
REG ORD ox; ! 


ok = ls 
tbp © Cirstbul: 
‘eas (tap) 


if ( ft flushlitbp) ) o = 0; 
} tbhp = tbhp->nextbuf; 


ceturn (ok); 


s 


[PCCePeeororererererereseLesaseseUsTEneLeveenesreneseroneneTeLeeeEeTeCETee/ 


/* Pill the indicated disk buffer with the current track and sector °/ 
[APOC Mee Te Te CL COeTEETELE AAU LEETETEL EDEL LOSE CEE TOTES HOCETED ED LOL CELL C NE EET/ 


fi11( top) 
REG struct ebste *tap; 


if ( tbpeovalid && thp->dirty ) ok « flushl (tbp): 
else ox = 1; 


if (ok) ok = dakxfer(setdsk, settrk, tbp->buf, DSKREAD); 


tbp~>valid = ok; 
thp->dirty = 0; 
thpe>erk = settrk; 
thp->dsk © setdsk; 


ceturn(ok); 


LoweveneereaaanereserevereeesensesevereeweseversorerseeroeererenseeeonseS/ 


7 Return the address of a track ouffer structure containing the e/ 
hed currently set track of the currently set disk. ©, 
/ HeMRTeaAseTerouseeeeseTELeLeLerTELeNLeETeEEeLENEeLENESeLEESECCLTETETe/ 


be oe ‘thatr *qeetrk() 
REG struct tbets *tbp; 


REG struct thstr *ltbp; 
REG struct tbstr *etbp; 
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tT SE TREE, SE AS i 
- 


REG WORD (iasave; 
/* Check for diss on-line — if not, ceturn eccoe */ 


imsave © setimask(7); 
12 ( ! dskstate({ setdsk] .ceady ) 


secimask (imsave); 
the = OL; 
ceturn (tbp)s 


} 


/* Seacch through buffers to see if the cequired stuff ¢/ 
/* is already in a buffer Lf 


tbp = Cirsebuf; 
itbp = Os 
mtop = QO; 


while (tdp) 


if ( (tbp->valid) s& (tbp->dsk *e setdsk) 
&& (tbo->tck == settrk) ) 


v (1tbp) /* found it — ceacrange LAU links */ 


ltbp-=>nextbuf * tbp->nextbufl; 
tbp->nexebuf «© ficstbuts 
fiesebufl = tbps 


setimask ( imsave) ; 
ceturn ( tbhp ); 


else 


atbp = lebp; /* move along to next buffer */ 
Lebp = top; 
thp = tbp->nextbul; 


/* THe stuff we need is not in a buffer, we mst make a buffer *%/ 
/* available, and fill it with the desired track */ 


if (mebp) atbp->nextbuf = 07 /* detach leu buffer */ 
ltbe->nexebuf © ficsebul; 
firsebuf = Lebp; 


setimaak(imsave): 
if (flushl(lebp) 66 £i11(lepp)) — = ltbpr /* success */ 
else atbp = OL; /* failuce */ 


ceturcn (tbo) ; 


Listing D-1l. (continued) 


iniormation Prasented Here is Proorietary to Digital Research 


85 


a oe Ral it 


D EXORmacs BIOS 


= MES ad SLAVNEAGS 84V9 


[ree eerasoarerecccceasovccvccnstesesesevoroueneeceeueeeescorsacecesooscee/ 


7* Stos READ Punction -- read one sector & °/ 
[eee re eeserewnweeeereceseconseeseneeeeverenveneTeroeoeereeeteeteeceneeee/ 


‘baal 


REG WORD is : . e 
REG struct tbstr *tbhp; >) : 
thp = gettrk(); /* locate track buffer vith sector e 

if ( t thp ) ceturn(1); /* failuce */ 

7* locate sector in buffer and copy contents to user area °%/ 


p= (tbp->obul) + (secsec << 7); /* aultiply by snifting */ 

q* setdma; 

{ = 128; 

do [*qre = epee: i -= 1;} wnile (i): /® this genecates good code */ 
ceturn (0); 


[cove souscerascereevecureseseererecerecooenrooueetourecoveseseeneveseceee/ 


ve BIOS WRITE Punction -=- write one sector °/ 
/eeeeeccecevsvessecereaereveareseseeeeesersesonesenereeoueccesecotesesese/ 


wt ite( mode) 

ce nodes 
R&G BYTE *o; 
REG BYTE *q3 
REG WORD is 


REG struct tbstr *tbp; 
7* locate crack buffer containing sector to be written */ 


top = gettrk(); 
if ( ! tap ) cecurn (1); /* failure ¢/ 


/* locate desired sector and do copy the data from the user ares */ 

P= (thp->buf) + (setsec << 7); /* multiply by shifting °/ : ) 
q * setdma; 

i = 128; 

do [*pee = *qees i -e 1:} while (i)7 /* this generates good code */ 

tbperdirty-s 1; /* the buffer is now “dirty® */ 

/* The track aust be written if this is a disectocy write */ 


if ( mode om 1 (if ( flushl(cbp) ) ceeuen(0); else cetuen(1);} 
else ceturn (0); 
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} 


pelse 


[OTe e OOD OCR SOOO RE ECO EE CASES OLE LES EHHERESLCCSL CLO CELESTE EENEOHENTET/ 


/e Read and Weice functions for the Loader s810$ es 
[Om OC eam erereceeeeense eee eTeeersesTOTseTTTOT LOC STODUELOCELOETCESECTEETEE/ 


pean) 


REG BYTE *p; 
REG BYTE °q; 
REG WORD 1; 


. 1£ ( ( (f dufvalia) |{ (buferk !© seterk) ) 6& 
( ! dskxfec(setdsk, sectrk, dbufltrk, OSKREAD) } ) {ceturn(L);} 
bufvalid = 1; 
buftre = secerks 
p* dbufltrk + (setsec << 7); 
q * setdma; 
i = 1283 
da { "qe = "pee: i-el; | wile(i): 
cetucn(0): 


} 


tendift 
[ATMOS RHC ARAL TELAT ETCAHEREH LAH OOTELOSEN ONL ENOS TELE ETENIE CEH CTCENTONELOE/ 


e BIOS Sectoe Translate Function «/ 
[RAMS CM RAHEDELOCCELED EOL EAAECLE SELATAN EHTESIOLELETROTERETEHELLOTCLEEHEE/ 


WORD sectran(s, xp) 
REG WORD s3 * 
tae BYTE *xp; 


if (xp) ceturcn (WORD) xp{ sj; 
else ceturcn (81); 


[CCCS CORO OSES EDLC OROR CR LEHEREHORETUOTLORSODESEONEAOCERETES ELEN HENETOLe/ 


/* BIOS Set Exception Vectoe Punction ey 
[CMON CCA N ATA EREL LENE LEL ATTEN HEELS LTOLTCTHOLOTS CORR SELENHEEETLEHEESECEL/ 


LONG setxvect(vnus, vvel) 
WORD vnuays 
| a vvel; - 


REG LONG oldval; . 
REG BYTE “vice; 


vice © ( (long) vnum ) << 2; 
Oldval = vloc->lvords 
vioc->lword = vval; 
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cetuco(oldval); 


[VUOPOSLOCHHEHEDOOCATOS COST EOS OLETH USE ETHOS CUE SETS ESTO SOO TEE SE SSEESEOEEe/ 


fe BIOS Select Disk Punction e/ 
[MPCCRHCH SS CLELEOTEELEE OEE NSE LET SET ENROL TTONNS ICO OSEORICHEE ETON ERT OSEEe/ 


! . 
LONG slctdsk(dsk, logged) rd 
REG BYTE dsk; 
BYTE loggedr - : 


REG struct dph “*dphp; 
REG BYTE sel, st2; | 
SYTE stpkt(STPKTS2); . 


“secdsk = dsks /* Record the selected disk number */ 


eif | LOADER 


/* Speetal Code to disable drive C. On the EXORmacs, drive C id 
/* is the non-cemovable hard disk. */ 


pee ieee eee {{ ( desk s= 2) ) 


perineser(*neSlOS ERROR -- DISK *); 
portouc(PORTL, ‘A’ *dsk); 
printser(* NOT SUPPORTEDNE®) + 
} ceturn (OL); 
naif " 


dphp = edpohtabd( dak]; 
a ( ! (logged & Oxl) ) 


hmpack.dskno = cnvdsk(setdsk]; 

hmpack.coml = 0x30; 

hmpack.com2 © 0x02; . 
actvdsk = dak; : 

dsk state({dsk} .change = 0; 

sendpkt(Ghmpack, 7); 


if ( ! dwewait(dsk, 0x72, Oxd) ) t 
sendack()3 ’ ) 
tpestate © IDLE: ‘ ‘ 
} return ( 0% )3 
getatpet( stpkt) ; /* determine disk type and size */ 


sendack (); 

ipestate = IDLE; 

stl = stpkt(PXTSTPRA]; 
St2 = stpkt(PKTSTPRNSL) 
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ce ( stl & Oxso ) 


dskseate{dsx]| .ceady © 0; 
teturcn (QL); 


} 
else 
asxstate(dsk] .ceady © 1; 


switcn ( stl & 7 ) 
{ 


D EXORmacs BIOS 


/* not ceady / teady °*/ 


case lL: /* floppy disk */ 
dpnp->dpbp = sdpod; 
oreak; 
case 2: /* nacd disk °/ 
dpnp->dpop = edpbd2; 
DSreak; 
default : biosecr(*Invalid Disk Status®*); 
@php = OL; 
Oceak; 


i } 


cetucn(dphp) ; 


#if ! LOADER 

[MACOS C He SESE HHO EE SEE HE ODE AEL ETH TOTOOESESU LOOT OTSETETE OE ETETETEe/ 
7e °/ 
7? This function is included as an undocumented, e/ 
/* unsupported method for EXORmacs users to format °/ 
/* disxs. [t is not a part of CP/M-68K proper, and ys 
ve 1g only included hece foe convenience, since the «/ 
/* Motocola disk controller is somewhat complex to «/ 
/* progcam, and the BIOS contains supporting routines. i'd 
fe « 


/ eeereoan COCO OOH T ATES OTD TER AHETTE AH EROTHOURHESOSUSESEREESOEe/ 


focmat(dsk) 
co WORD dsk; 


REG WORD cetval; 
if ( ! sletdsx( (BYTE)dsk, (BYTZ) 1) } cetuen: 


Cmtpack.dskno = cnvdsk{ setdsk]; 

actvdsk = setdsk; 

dskstate(setdsk}.cnange = 0; 

sendpkt(sftatpack, 7); 

if ( ! dskwait(setdak, 0x70, 0x0) ) cetval = 0; 
else cetval * i;° 
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Sendack(}3; 
spestate * IDLE; 
cetucn(cetval); 


bendif 
[POC OMOCREOSEHES SEL EEOED CLOT OTTESE SEO LOLOL TES ESSE OEE OS SOO SESS HHELEE TET Oe / 
fe : * 
fe Sios initialization. Must be'done before any cegular SI0S «/ 
ve calls ace per forned. H/ 
e 
[ PASSO HHHOESOROH EHO ORC HEOL OSHS OSE OEOTTOHOS SOOT ESOSOHO ESET OLEHLTUL ESTES / 
pene 

initpres(): . 
,; inatdsks(); 
inatpeets() 


poe tinit (PORTL) 
port init (PORT2) 3 


I 


initdsesa() 


REG WORD is 
REG WORD imsaves 


! LOADER : 
fee ee meee oot) 


tbuf(il.valid = 03 

eout(i] dirty = O- 

if ( (i*L) < NOMTB ) ebuf[i].nextbuf = sebuffiell: 
else tout(i].nexebuf = 03 


Cirstpuf = sedufllOl; 
lastbuf = &thuf{NUMTB-L]; 
telse 


tendif 


butvelid = 03 


de a i <= MAXDSK; i +e 1) 


dexstate(i].state * IDLE: 
dsxstace(i}.ceady = lL: 
dskstacte{i] change © 0; 


imsave = setimask (7); 
inccoune =» 0; 
ipestate = IDLE; 


/* turn off interrupts °/ 
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socimask ( {msave}: 


/* tun on interrupts */ 


D ExXORmacs BIOS 


°/ 


} 
[PASS SSOSEDOOEHSESS ORE HS CLE EERESEEOOES SEDO SES OOSOSSE SATE SOLESEHOEESOESEOS 
/* 
/e BIOS MAIN ENTRY -—- Branch out to tne various functions. 
e 


°/ 
e 


[ TEMS COR HSSEAOLELOESEHOS ORO OS HERES HO ERSCEEEOHER OSS OSETOOTEOSEHEESEESONOEE/ 


LONG cdbios(d0, di, d2) 
a0 


REG WORD 


3 
ba LONG dl, d23 


oe (a0) 


case 


if 1 LOADER 
case 


tendiz£ 
case 


case 
case 


case 
case 


case 
case 


case 


Qs 


T3 
/* 


9: 
/e 


diosinie(): 
breaks 


flusn(); 
initadsks()3 
whoot();: 
Dreaks */ 


return( por tata ct (PORTL)) 3 
breaks */ 


* cetucn( poc tin (PORTL)) 3 


Sreak;. */ 


poe toue(PORTL, (char) dl); 
break; 


z 

portout(PORT2, (char) dl); 
dreaks 

retuen ( poe tin (PORT2)) ; 
break: °/ 


settrk = 03 
break: 


7? 


se 


«ee 


T hed 


7e 


/* 
/* 


Fad 


/* 


InNtrT 


WwEOOT 


CONS? 


CONT! 


CONOUT 


Ist 
PUNCH 


READER 


°/ 


/ 


°/ 


*/ 


°/ 


if 
*/ 


“/ 


*/ 


return(sletdsk((charc)dl, (charc)d2)): /* SELDSK °/ 


break; */ 


case 10: settrk = (int) di: 


DOreak; 


case Ll: setsac = ((inet)dl-1); 


Oreak; 
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ee nee ere ee + = cee we ts ee ere ee ene em pe 


case 12: setdms © al: /* SETDMA °/ 
oeceaks 


case 13s retuecn(read{))s /® READ “/ 
/* drean: */ 
-642 1 LOADER 
case Lés rcetucn(write((chac) dl)): /* WRITE °/ 
/* drears */ 


7 . 
case LS: if ( * (BYTE «) (PORT2 + PORTSTAT) & PORTTDRE } . 
‘ceturn ( OxOfEf )3 . 
else cetucn ( 0x000 ); 
/* dDeeak: */ 


fendif 
case 16: return(sectran((int)dl, d2)); /* SECTRAN °/ 
/* breaks */ 
#10 ! LOADER 
case 18: return (&memtad) /* GMRTA e/ 
/* breaks */ 
case 19: ceturn(iobyte)s /* GETIOB ef 
/* break; */ 
case 20: iobyte = (inte) dl; 7* SETTOB / 
Dreak; 
case 21: if (flusn()) cetuen(0L)s /* FLUSS e/ 
else cocucn(Oxtf2eL) 3 
/* break; */ 
aif 


case 22: returcn(setxvect( (int) dl,d2)); /°* SETXVECT */ 
/* doreaks */ 
exc ! LOADER 


[Meeeeenccevcerseaercoescesecesvorceneseossesessoreensonlee/ 


/* This function is noe part of a standard 310s. e/ 
/* It is included only for convenience, and will / 
/* not be supported in any way, nor will it */ 
/* necessarily be included in tutuce versions of i A 
/e CP/M=68K «/ 


/PeReoeece nerve ressoveseoreresscevereneseowrseneoesessesese/ 


case 63: ceturcn( ! focmet({ine) dl) )s /* Oisk Pormacter */ 
/* break; °/ 


defaults ceturcn(0L); * S 
oreak; 


} /* ead mviteh */ 


tendif 


} /* mp OF Bros *°/ 
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7* End of C Bios *%/ 


NORMBIOS.H 


This should be cenemed “SIOSTYPE.d® 1f you are comoiling a 
nocmai alos. 


tdeline LOADER 0 
tdefine CTLTYPE 0 


LOADBIOS .# 


This snould Se renamed "3IOSTYPE.H° if you ace compiling a 
loeder 3108S. 


tdefine LOADER 1 
tdefine CTLTYPE 0 


BIOSA.8 
This 18 the assembly Language interface needed by the normal 
Bros. 


«text 


Listing D-l. (continued) 
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-globl 
-globl 
-globl 
-glodl 
-globdl 
-globl 
-glodl 
-glool 
-globl 


init: lea 
a move.l 
lea 
move.l 
nove 
jse 
ele.l 
cts 


skia: Link 

movers. l 
jst 
mover. 
un lk 
ete 

J 

~S@tima3zx: move 
Lse 
and.l 
move 
roc .w 
and. 
add.w 
coc.w 
aove 
ets 


end 
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inie 
biosinit 
flusn 
wooot 
cbios 
dskia 
dskic 
_setiaask 
SP ’ 


entry,ad 
a0 .$ 8c 
ask ia,ad 
ad .$3fe 
#$2000,s¢ 
_2s0s init 
Cy) 


a 
_ceP 


42,-(a7) 
al,-(a7) 
a0,-(a7) . 
_cbios 
#10,a7 


a6.80 . 7 
d0-47/a0-35,-(a7) 
_daskic 

(a7) ,d0-d7/a0-a5 
a6 


sc,ad 

48,00 

87,40 

se,al 

e8,dl 

eseeta, al i 
4(a7),dl 

¢8.a1 

dl,se 
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UDBLOSA.S 
This is the assemply Language intecface used by the loadec 
BIOs. 
text 
Say -giool _bios 
4 -glodk _dSrosinit 
-glool _cdtos 
Su -qlooL _dsxia 
-glool _dskic 
-GlooL _setimask 
° a 
e 
e 
e 
dios: ink aé,80 


ROove.L d2,-{a7) 
move.L dl,-(a7) 
move.« 40,-(a7) 
move #$2000,sr 


tea udsk13.a0 
move. t a0,$3fe 
jsc _cd103 

un lk ao 

cts 


dskiaz Lins a6,00 
movem. lL d0-47/20-a5,-(a7) 


jse dskic - 
mover. Ll (a7)¢,d0-d7/ad-a5 
un ik a6 

ete 


e 
S@cimas<: nove 3,350 


Lse #8,30 
and. $7,340 
move se, ol 


cot.w $a,d. 
and.w eS€Ei%4,41 


add.w 4(a7),a1 
¥ coc.w e8,dL é 
{ ‘\ sove dl,se 
5 : ets 
N\ . ° 
: -end 
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Serre EC eC 6 NEN a ert enone anne eens epee oe soe: 
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BIOSTYPS .8 
These type definitions zre needed by the C SI0s. 


[ PECHOORCSRESOS SONS SHETURERS TES SCENTS ONTETIOCLOS/ 


/* °/ 

7e Portable type definitions for use e/ . 

/* with she C BIOS according te e/ 

7* CP/M-68K (tm) standacd usage. */ ee 
. e 4 
{ VECOSCOLTOS EROS HOSENAAHEHEeHSSETOFERESE TOTS EROe/ 


§define LONG long 

tdefine ULONG unsigned long 
$define WORD shore int 
tdefine UWORD unsigned shore 
tdefine BYTE char 

tdefine UaYTE unsigned char 
tdefine VOoTD 

tdefine REG cegister 
§define LOCAL = auts 

tdeftine MLOCAL static 
fdefine GLOBAL extecn 
tdefine EXTERN extern 


[ COCCOHEHELE DE STOOTECTOTOSSE TELE TSSCTAHAERATETOEE/ 


Listing D-l. (continued) 
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Appendix E 
Putboot Utility Assembly Language Source 


009 Asseanlecr Revision 02.01 Page 1 


Source File: putpoot.s 


Wan Veuner 


28 90000000 


30 00000000 
31 90000004 
32 90000008 
33 goocaacc 
34 30000012 
3$ 00000018 
36 QO0ONALC 
37 900000 20 
38 00000022 
39 00000024 
40 000000 26 
41 000000 2A 
42 000000 2E 


PPPTTTTITI ICT TTT ry hii 


e . e 
id Program to Weite Soot Tracks for CP/M-68K (ta) ¢ 
. e¢ 
° Copycight Sigital Research 1982 ° 
e e 
SORES HSTESSEHHEHSSOSSEESEAOORARO HE HOHEE EHO THUESLOHETTTES 
e 
s 
e 
pentstrc © 9 BDOS Functions 
dseidsk = 14 
open = 15 
teadseq = 29 
dsetdma = 26 
e 
seldsk = 9 BIOS Functions . 
sectrk * 10 
setsec = ub 
-: isetdima = 12 
weice = 4 
sectcan = 16 
Elusn . au 
e 
bufene # $80 
bufsize = $80*butene 
e 
- text 
e 
4£560000 . stact: Link a6,40 
206E9008 move.l 8(a6),a0 base page address 
43E8095C lea $Se(a0),al 
23¢900004030 sove.l al, fed. 
423900004094 ele.d nflag 
oorcodal add #$31,a0 fiest chacactec Of command tail 
0€180020 scan: cmi.d €$20,(a0)¢ skip ovec dDlancs 
S7FA beq scan 
5388 sub.1 #1,a0 
4A1L0 scanl: tst.5 (ed) 
§7000LA4 peq erxit 
0¢ 180020 empi.d @S 2d, (a0)+ check foc -# Clag 
66 26 bane nonypn 
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Research 


ways ce 


-43 90000030 
44 00000034 

. 45 90000038 
46 00000038 
47 90000042 
48 QOQ0004A 
a9 90000054 
50 00000056 
SL 000000SA 
$2 ao0000s 
$3 00000060 
54 00000062 
$$ 00000066 
cessu 68 


w~wee 


00180048 
66060196 
4A39300004094 
6600018 


L3PC OOF FO000 4094 
048 9000000 2400004080 


6006 
0100020 


00 


Soucce Pile: putboot.s 


$6 90000068 
$7 0000006C 
$8 00000070 
$9 000000764 
60 00000078 
61 9000007C 
; 62 00000078 
63 00000080 
64 90000084 


Q000008A 

' 90000088 

| 90000094 
.~ 00000096 
72 GOQ0009A 
73 9000009C 
74 0O0000A2 
78 QO0000A8 
76 OOOCO0AE 


80 ooa000s2 
81 00000088 
82 cococoBEe 
a3 ogosgoc2 
@4 oooco0cs 

_ 88 oooacecs 
86 Q00G00CA 
87 99000000 
86 00000002 
39 00900004 
90 00000006 
91 0000000C 
92 d00000E2 
93 000000eA 
94 GOQO00EE 


04500020 
0c10004) 
6DOO0OLSA 

0¢ 100050 
6000152 
1010 

4880 
90700041 
33C00000408A 


30 3¢000P 
223900004080 
4642 


223000000034 
4£F 900000 1D2 
207900004080 
42280020 


263¢€00000000 
427900004088 
30 3ICO0 LA 
2202 

4642 
3oxcooLs 
223900004080 
48462 

4040 

661A 

048C 00000080 
$27900004088 


0C79008000004¢68E 


6E0Q00FE 
6oce 


—-s---o 


nohypns 


scan2: 


Asseambleec 


upper: 


openock : 


tloop: 


$$ 48, (20)+ 
erxit 
nflag 
ecxit 
eset, nflag 
#$24, ten 


scan 

#820, (a0) 
seanl 

$$ 20, (ad) 
scan2 
#$61,~-(20) 


upper 
Revision 02.01 


#$ 20, (a0) 
$841, (a0) 
erxit 
#$50, (a0) 
erxit 
(a0),d0 


a 
$$41,d0 
40 ,dsk 


2 

#$00 ¢f,d0 
openok 
topntl,dl 
ecx 

fcp, a0 

32 (a0) 


fen, al 


change to 2nd default fcb 
* 


get disk letter 
upsnift 
Page 2 


compace with cange A - P 


pue disk Lettee into cange 0 - 15 
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9s e 

96 e weite 

97 e 

98 d00000F0 303c0009 wetout: move.w ¢seldskx,d0 select the disk 

99 OOCO0OF4 32390000408 sove.w dsx,dl 

200 JO0000FA 4202 ele.d d2 

lol Goooascre «z43 trag $3 

202 Q00cGc0erFE wea tse.l @ check foc selece error 
103 90000100 67000008 Seq selecx 

L04 v0000L04 2040 aove.l d0,ad 

20S 30000106 20680008 move.l 14(a0},a0 get OPB address 

106 QO000LOA 330000004084 zove.w (20),spe gee sectors perc track 
107 OOOOOLIO J3zEaG0OEQOOCCGEC move.w 14(a0),o0ff gee offset 

108 00000118 427900004088 ele.w tek sStact at erk 0 

L109 90000L1E 33FC000 L00004086 gove.w ¢1,sect Stact at sector i 
110 09000126 417900000000 lea buf, ad 
crs €s8sagqao AZSQseamodlec Revision 02.01 Page 3 
Soucce File: pgucbeoe.s 

LLL OC000L2C 403900004096 est.d hflag 

112 00000132 660¢ bane weel 

113 00000134 2CS060LA cmpi.w $3601a, (a0) 

114 00000138 6606 dae weel 

LLS QOOOOL3A DLPCODONDOIC add.l #28,a0 

116 00000140 23C800005090 wetl: move. a0,0utp 

117 ® 

218 00000146 4a790000i082 wloop: ¢st.w coune 

119 QO00OL«C 6774 exic 

120 00000142 3123900004086 move.w sect,dl eneck foc end-of-track 

121 00000154 327999004035 r cmap.w spe,dl 

£22 QOGOOLSA 6PLE ble sok 

123 QO0O0OLSC 33PC000 LQO00S CaS move.w #l,sect advance to new track 
124 00000164 30390000¢0a8 aove.w erk,¢0 

125 QOQO00L6A $240 add.w §=#1,20 

226 Q000016C I3cO00CORCKa gove.w dQ,trk 

127 00000172 s079005c408C cmyp.w off,d0 

128 00000178 6c78 oge oflex Pe 

29 DOOCOOL7A 303C000a SOR: Tove.w $seter<,d0 set the track 

130 00000172 323900008088 move.w erk,dl 

L3L CO0U01a4 4243 trap #3 

132 00000134 323900004086 gove.w sect, dl set sactorc 

133 a0000L8C 3o3C9008 move.w §satsec,d0 

134 00000190 «Zz 43 trap #3 

135 00000192 3903CQ00C move.v tisetdm, a9 set up dm address foe veite 
136 G0000196 223900004090 : move.l oufp,dl 

LI7 00000i:S9C 443 trae 

138 00000192 joIcOooCE mgove.w tweite, dd and write ? 
139 000001A2 4241 cls.w dh 

140 Q0000LA4 1243 trep 63 

141 COQOOLAG «aco ese.w a cheek foc weite error 
242 OOQCOOLAS 6638 bane wetecs 

143 00000 LAA. 527900004086 edd $1,sece {acre@ent sectoc nuaberc 
344 00000130 5379C00G0eQ8Z sub tL,counet 

145 00000186 0689000000800000¢090 ada.i 9128 ,dutp 

446 Q000K1CO 6084 Bea wloog 

Listing E-l. (continued) 


System Guide 


E PUTBOOT Utility 


CY/M~OOK 


148 000001C2 
149 000001C6 
130 oo0c01Ccs 
1$1 GOGQ01CA 


183 00000iCcc 
184 000001D2 
185 00000106 
186 00000108 


188 OCO001LDA 
159 000001£0 
160 000001E2 
161 QOO0C LES 
162 OCOOOLEA 
163 000001Frq0 
164 900001LF2 
165 oOo00LFS 
ce/n 68 


pystem vulue 


3630015 
4843 


223000000000 
30 x0009 
«B42 

60B8 
223¢€00000017 
60Fr0 
223€000006 26 
60z8 
223000000048 


§0e0 
223¢€00000060 
60D8 


000 Asseambdlec 


Source Piles putboot.s 


7 
168 90000000 
170 * 
472 900000000 


174 00008080 
L7$ 900004084 
176 00004086 
177 00004088 
178 0000408A 
179 0000408C 
180 00004082 
181 00004090 
182 00004094 


184 00004096 
184 90000000 


186 00000000. 
186 doocGcas 
186 00000010 
187 006000017 
187 cagcodLr 
ts@ 90000026 
188 0000002 
189 00000034 
189 9000003¢ 
189 90000044 
189 o000004C 
190 0000004E 


49 6B 766160696420 
436F 60606 16£6 420 
4C 59 GE 6S0D 0A 26 
$3656C6563742045 
727.2627 2000A24 
$77 2697465206572 
726F7 20D0A24 

436 LEZGE GP 74204" 
706568 205 3677572 
6365 204669606500 
Qa24@ 

427 $66666572204P 


exit: move.w 
trap 
un lk 
ets 


ecxit: saove.l 

erx: aove.w 
trag 
bra 


selerx: sove.i 
bra 

wetecx: aove.l 
ora 

bufoftix: sove.l 


oflex: move.l 


febs ds. 
spe: ds. 
sect: -ds.w 
ecks ds. 
dsks -ds.w 
off: ds. 


ecstr: .de.d 


selstrc: .de.b 
wetstr: .dc.b 


opn(l: .de.s 


cufofl: .de.b 


Listing E-1. 


$Clusn,dd 
$3 
a6 


fecste,dl 
#peneser, dd 
$2 

exit 
#eaelstr,dl 
ercx 
évetstr, dl 
ecx 
#bufotl, dd 


ers 
$erkof1, dl 
erx 


Revision 02.01 


outs izeel2s 


Ped ed od ad ol od 


as CVU LOI hb Uw ose vy 


exit location - flush bios buffers 


and exit w CCP 


giscellaneous errors 
peint ecror sessage and exit 


disk select error 
disk write error 


outfec overflow 


Page 4 


feb address 

sectors pec track 

current sector 

current track 

selected disk 

lst erack of non-doot area 


"Tavalid Command Line’,13,10,‘$° 


"Select Serorc’,13,10,°S* 
‘weite Beroc’,13,10,'$" 


"Cannot Open Soucce Pile’,13.10,'S° 


‘Buffer Overflow’ ,13,10,'$° 


(continued) 
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a 


Se eee. Org Ree, SEE 


Swe Lee Berea 


ee Orne ee Cee i ee bee wee cores 


wee ee wwe eM gw wwe ew www 


190 00000056 766572666C6P7700 
190 QOOQ00SE OA24 

191 00000060 S<éP6P 2040756368 
L9L 00000068 2044617461 20666F 
9k 00000070 7220837973746560 
191 00000078 205472616 3687300 
19L 00000080 OA24 - 

192 


-— 193 


194 00000082 
CPpss 6g90090 Assen 


reer. Source Pile: putboot.s 


Syabdol Tabdtle 


buf 00000000 SSS oufene 
bufo 00004090 ass butsize 
dsecdma QQOQOGOOLA Ass dsx 
ecxit QOO00LCC TEXT exit 
hflag 00004094 3585 Lsetdma 
otlex QO00O0LF2 TEXT open 
pentstr 00090009 ABs teadseq 
scanl Q0000024 TEXT scan2 
seidsx 00000009 ags se lecx 
settck QQOOCOOA ABS so« 

trk 00008088 ass treotl 
werte QQQ0000E ass weel 


weestc 00000026 OATA 


Ail Inzormation Presented Here is Proprietary to Digital Researe 


trkofl: .de.b ‘Too Much Data for System Tracks',13,10,'$* 


end 
bleec Revision 02.01 


00000080 Aas bufotl Go00dg4Ee 
00004000 ABS) = count 0000408E 
QQ00408A BSS erstr 60000000 
QQ0001C2 TEXT fcp 00004090 


Q000000C ABS nonyph 0g000csé 
QOOCOOOF ABS openok 000000A8 
Q0000014 Aas t Loop Qoo000se 
GO00000SC TEXT sece 00004086 
GOOCOOLDA TEXT selstr 00000017 
QOOCOL7A TEXT spe 00004534 
00000060 OATA upper 0000005¢C 


00000140 TEXT wetecx 00000152 


oe -vemvve Vee be wy 


Page 3 


OATA 
383 
OATA 
BSS 
TEXT 
TEXT 
TEXT 
$S$ 
JATA 
383 
TEXT 


TEXT 


Listing B-l. (continued) 


End of Appendix E 
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oufoftix 
dseidsx 
ercx 
flusnv 
otf 

cen fl 
scan 
Ssectran 
setsec 
stact 
wloop 
wetout 


QOGOOLEA 
Q000000E 
00000152 
00000015 
g000¢08C 
90000034 
googaaic 
00000010 
00000008 
90000000 
00000146 
gooooora 


a 


aa 


f™ 
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Appendix F 
Motorola S-Records 


F.1l S-record Format 


The Motorola S-record format is a method of representing 
binary memory images in an ASCII form. The primary use of S-records 
is to provide a convenient form for transporting programs between 
computers. Since most computers have means of reading and writing 
ASCII information, the format is widely applicable. The SENDC68 


utility provided with CP/M-68K may be used to convert programs into 
S-record form. 


An Serecord file consists of a sequence of S-records of 
various types. The entire content of an S=-record is ASCII. When a 
hexadecimal number needs to be represented in an S-record it is 
represented by the ASCII characters for the hexadecimal digits 


comprising the number. Each S-record contains five fields as 
follows: 


Ll 2 2,—4-er- 6 


Characters: 1 variable _ 2 


/ / ¢ 
“7? & OW gy 


Figure P-l. S-record Pields 


The field contents are as follows: 


Table F-l. S-record Field Contents 


The ASCII Character ‘S'. This signals 
the beginning of the S-record. 


A digit between 0 and 9, represented in 
ASCII, with the exceptions that 4 and 6 
are not allowed. Type is explained in 
detail below. 
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fable F-l. (continued) 


The number of character pairs in the 

cecord, excluding ‘the first three : 
fields. (That is, one half the number > 
of characters total in the address, 

data, and checksum fields.) This field 

has two hexadecimal digits, representing 

a one byte quantity. 


address The address at which the data portion of 
the record is to reside in memory. The 
data goes at this address and 
successively higher numbered addresses. 
The length of this field is determined 
by the record type. 


The actual data to be loaded into memory, 
with each byte of data represented as a 
pair of hexadecimal digits, in ASCII. 


checksum A checksum computed over the length, 
address, and data fields. The checksum 
is computed by adding the values of all 
the character pairs (each character pair . 
represents a one-byte quantity) in these * 
fields, taking the one's complement of ") 
the result, and finally taking the least 
significant byte. This byte is then 
represented as two ASCII hexadecimal 
digits. 


¥.2 S-record Types 


There are eight types of S-records. They can be divided into 
two categories: records containing actual data, and records used to 
jefine and delimit groups of data-containing records. Types 1, 2, 
and 3 are in the first category, and the cest of the types are in 
the second category. Each of the S-record types is described 
individually below. 
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CP/M~68K System Guide F.2 S-record Types 


Table F-2. S~rcecord Types 


This type is a header record used at the beginning 
—- of a group of S-records. The data field may 
contain any desired identifying information. The 

address field is two bytes (four S-record 

characters) long, and is normally zero. 


This type of record contains normal data. The 
address field is two bytes long (four S-record 
characters). 


Similar to Type l, but with a 3=-byte (six S-record 
characters) address field. 


Similar to Type 1, but with a 4-byte (eight s- 
record Characters) address field. 


This record type indicates the number of Type l, 
2, and 3 records in a group of S-records. The 
count is placed in the address field. The data 
field is empty (no characters). 


This record signals the end of a block of type 3 

S-records. If desired, the address field is 4 

i bytes long (8 characters), and may be used to 

te contain an address to which to pass control. The 
id data field is empty. 


This is similar to type 7 except that it ends a 
block of type 2 S-records, and its address field 
is 3 bytes (6 characters) long. 


This is similar to type 7 except that it ends a 
block of type 1 S-records, and its address field 
is 2 bytes (4 characters) long. 


S-records are: produced by the SENDC68 utility program 


(described in the CP/M-68K Operating System Programmer's Guide). 


End of Appendix FP 
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Appendix G 
CP/M-G68K Error Messages 


‘This appendix lists the error messages returned by the internal 
components of CP/M-68K: BDOS, BIOS, and CCP, and by the CP/M-68K 
System utility, PUTBOOT. The BIOS error messages listed here are 
specific to the EXORmacs BIOS distributed by Digital Research. 
BlOSes for other hardware might have different error messages which 
Should be documented by the hardware vendor. 


The error messages are Listed in Table G-l in alphabetic order 
with explanations and suggested user responses. 


fable G-1. CP/M-68K Error Messages 


bad relocation information bits 


CCP. This message is a result of a BDOS 
Program Load Function (59) error. It indicates 
that the file specified in the command line is 
not a valid executable command file, or that 
the file. has been corrupted. Ensure that the 
file is a command file. The CP/M-68K Operating 
System Programmer's Guide describes the format 
of a command file. Tf the file has been 
corrupted, reassemble or recompile the source 
file, and relink it before you reenter the. 
command line. 


BIOS ERROR -— DISK X NOT SUPPORTED 


BIOS. The disk drive indicated by the variable 
*X" is not supported by the BIOS. The BDOS 
supports a maximum of 16 drives, lettered A 
through P. Check the documentation provided by 
the manufacturer for your particular system 
configuration to find out which of the BDOS 
drives your BIOS implements. Specify the 
correct drive code and reenter the command 
line. 
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Table G-l. (continued) 


BIOS ERROR <= Invalid Disk Status * 
! 


BIOS. The disk controller returned unexpected “) 
Or incomprehensible information to the BIOS. 

Retry the operation. If the error persists, 

check the hardware. If the error does not come 

from the hardware, it is caused by an error in 

the internal logic of the BIOS. Contact the 

place you purchased your system for assistance. 

You should provide the information below. 


1) Indicate which version of the operating 
system you are using. 


2) Describe your system's hardware 
configuration. 


3) Provide sufficient information to reproduce 
the error. Indicate which program was 
running at the time the error cecurred. [If 
possible, you should also provide a disk 
with a copy of the program. 


: ia 
Buffer Overflow — 2 


PUTBOOT. The bootstrap file will not fit in 
the PUTBOOT bootstrap buffec. PUTBOOT contains 
an internal buffer of approximately 16K bytes 
into which it reads the bootstrap file. Either 
make the bootstrap file smaller so that it will 
fit into the buffer, or change the size of the 
PUTBOOT buffer. The PUTBOOT source code is 
supplied with the system distributed by DRI. 
“Equate bufsize (located near the front of the 
PUTBOOT source code) to the required dimension 
in Hexidecimals. Reassemble and relink the 
source code before you reenter the PUTBOOT 
command line. 


_ Cannot Open Source File 


PUTBOIT. #PUTBOOT cannot locate the source f 
file. Ensure that you specify the correct ) 
drive code and filename before you reenter the 

PUTBOC'‘T command Line. 
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CP/M-68K System Guide | G CP/M-68K Error Messages 


Table G-1. (continued) 


Message Meaning 


CP/M Disk change error on drive x 


BDOS. The disk in the drive indicated by the 
variable x is not the same disk the system 
logged in previously. When the disk was 
replaced you did not enter a CTRL-C to log in 
the current disk. Therefore, when you 
attempted to write to, erase, or rename a file 
on the current disk, the BDOS set the drive 
Status to read-only and warm booted the system. 
The current disk in the drive was not 
overwritten. The drive status was returned to 
read-write when the system was warm booted. 
Each time a disk is changed, you mst type a 
CTRL-C to log in the new disk. ' 


CP/M Disk file error: filename is read-only. 
DO you want to: Change it to read/write (C), 
or Abort (A)? 


BDOS. You attempted to write to, erase, or 
rename a file whose status is read-only. 
Specify one.of the options enclosed in 
parentheses. [£ you specify the C option, the 
BDOS changes the status of the file to read- 
write and continues the operation. The read- 
only protection previously assigned to the file 
is lost. 


Tf you specify the A option or a CTRL-C, 
the program terminates and CPM-68K returns the 
system prompt. 


CP/M Disk read error on drive x 
Do you want to: Abort (A), Retry (R), or Continue 
with bad data (C)? 


BDOS. This message indicates a hardware error. 
Specify one of the options enclosed in 
parentheses. Each option is described below. 


Option Action 


A or CTRL-C Terminates the operation and 
CP/M-68K returns the system 
prompt. (Meaning continued on 


next page.) ‘ 
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fable G-l. (continued) 


CP/M Disk read error on drive x (continued) 


Option Action ) 


R Retries operation. If the retry 
fails, the system reprompts with 
the option message. 


Ignores error and continues 

program execution. Be careful 

if you use this option. Program 
execution should not be 
continued for some types of 
programs. For example, if you 

are updating a data base and 

receive this error but continue 

program execution, you can 

corrupt the index fields and the 

entire data base. For other 
programs, continuing program 
execution is recommended. For 

example, when you transfec a 

long text file and receive an — 
error because one sector is bad, > 
you can continue transferring uv 
the file. After the file is 
transferred, review the file, 

and add the data that was not 
transferred due to the bad 

sector. 


CP/M Disk write error on drive x 
Do you want to: Abort (A), Retry (R), 
or Continue with bad data (C)? 


BDOS. This message indicates a hardware error. 
Specify one of the options enclosed in 
parentheses. Each option is described below. 


Option Action 


A or CTRL-C Terminates the operation and 
CP/M-68K returns the system 
prompt. 


Retries operation. If the retry 
fails, the system reprompts with 
the option message (Meaning 
continued on next page.) 


. 
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CP/M~68K System Guide G CP/M-68K Error Messages 


Table G-l. (continued) 


Message Meaning 


CP/M Disk write error on drive x (continued) 


Option Action 


Cc Ignores error and continues 
program execution. Be careful 
if you use this option. Program 
execution should not be 
continued for some types of 
programs. For example, if you 
are updating a data base and 
receive this error but continue 
program execution, you can 
corrupt the index fields and the 
entire data base. For other 
programs, continuing program 

, execution is recommended. For 
example, when you transfer a 
long text file and receive an 
error because one sector is bad, 
you can continue transferring 
the file. After the file is 
transferred, review the file, 
and add the data- that was not 

transferred due to the bad 

sector. 


CP/M Disk select error on drive x 
DO you want to: Abort (A), Retry (R) 


BDOS. There is no disk in the drive or the 
disk is not inserted correctly. Ensure that 
the disk is securely inserted in the drive. I£ 
you enter the R option, the system retries the 
operation. If you enter the A option or CTRL-C 
the program terminates and CPM-68K returns the 
system prompt. 


CP/M Disk select error on drive x 


BDOS. The disk selected in the command line is 
outside the range A through P. CP/M-68K can 
Support up to 16 drives, lettered A through P. 
Check the documentation provided by the 
manufacturer to find out which drives your 
Particular system configuration supports. 
Specify the correct drive code and reenter. the 
command line. 
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Table G-1. (continued) 


File already exists 


! . 2 
CCP. This error occurs during a REN command. S 
The name specified in the command line as the ' 
new filename already exists. Use the ERA 
command to delete the existing file if you wish 
to replace it with the new file. If not, 
select another filename and reenter the REN 
command line. 


insufficient memory or bad file header 


cCP. This error could result from one of three 
causes: 


1) The file is not a valid executable command 
file. Ensure that you are requesting the 
correct file. This error can occur when you 
enter the filename before you enter the 
command for a utility. Check the 
appropriate section of the CP/M-68K 


Operating System Programmer's Guide or the 
| 


CP/M-68K Operating System User's Guide for ") 
the correct command syntax before you : 
reenter the command line. If you are trying 

to cun a program when this error occurs, the 

program file may have been corrupted. 

Reassemle or recompile the source file and 

relink it before you reenter the command 

line. 


2) The program is too large for the available 
memory. Add more memory boards to the 
system configuration, or rewrite the program 
to use less memory. 


3) The program is linked to an absolute 
location in memory that cannot be used. The 
program must be made relocatable, or linked 
to a usable memory location... The BDOS 
Get/Set TPA Limits Function (63) returns the 
high and low boundaries of the memory space 
that is available for loading programs. 
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Table G-l. (continued) 


Message Meaning 


Invalid Command Line 


PUTBOOT. Either the command line syntax is 
incorrect, or you have selected a disk drive 
code outside the range A through P. Refer to 
‘the section in this manual on the PUTBOOT 
utility for a full description of the command 
line syntax. The CP/M-68K BDOS supports 16 
drives, lettered A through P. The BIOS May or 
may not support all 16 drives. Check the 
documentation provided by the manufacturer for 
your particular system configuration to find 
out which drives your BIOS supports. Specify a 
valid drive code before reentering the PUTBOOT 
command line. 


CCP. The filename specified in the command 
line does not exist. Ensure that you use the 
correct filename and reenter the command line. 


No wildcard filenames : 
CCP. The command specified in the command line 
does not accept wildcards in file 
specifications. Retype the command line using 
a specific filename. 


Program Load Error 


cCP. This message indicates an undefined 
failure of the BDOS Program Load Function (59). 
Reboot the system and try again. If the error 
persists, then it is caused by an error in the 
internal logic of the BDOS. Contact the place 
you purchased your system for assistance. You 
should provide the information below. 


1) Indicate which version of the operating 
System you are using. 


2) Describe your system's hardware configur- 
ation. (Meaning continued on next page.) 
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fable G-l. (continued) 


Meaning 


3) Provide sufficient information to reproduce i 
the error. Indicate which program was “2 
running at the time the error occurred. Tf 
possible, you should also provide a disk 
with a copy of the program. 


read error on program load 


cCP. This message indicates a premature end- 
of-file. The file is smaller than the header 
information indicates. Either the file header 
has been corrupted or the file was only 
partially written. Reassemble or recompile the 
source file, and relink it before you reenter 
the command line. 


Select Error 
PUTEOOT. This error is returned from the BIOS 
select disk function. The drive specified in. 
the command line is either not supported by the 
: BIOS, or is not physically accessible. Check ; Cc) 
the documentation provided by the manufacturer ‘nat. 
to find out which drives your BIOS supports. 
This error is also returned if a BIOS supported 
drive is not supported by your system 
configuration. Specify a valid drive and 
reenter the PUTBOOT command line. 


SUB file not found 


CCP. The file requested either does not exist, 
or does not have a filetype of SUB. Ensure 
that you are requesting the correct file. 
Refer to the section on SUBMIT in the CP/M-68K 
Operating System User's Guide for information 
on creating a using submit files. 


Syntax: REN newfilesoldfile 


CCP. The syntax of the REN command line is >) 
incorrect. The correct syntax is given in the * 
error message. Enter the REN command followed 

by a space, then the new filename, followed 

immediately by an equals sign (=) and the name 

of the file you want to rename. 
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Table G-l. (continued) 


Message Meaning ; 


Too Many arguments: argument? 


CCP. The command line contains too many 
arguments. The extraneous arguments are 
indicated by the variable argument. Refer to 
the CP/M-68K Operating System User's Guide for 
the correct syntax for the command. Specify 
Only as many arguments as the command syntax 
allows and reenter the command line. Use a 
second command line for the remaining 
arguments, if appropriate. 


Too Much Data for System Tracks 


PUTBOOT. The bootstrap file is too large for 
the space reserved for it on the disk. Either 
Make the bootstrap file smaller, or redefine 
the number of tracks reserved on the disk for 
the file. The number of tracks reserved for 
the bootstrap file is controlled by the OFF 
parameter in the disk parameter block in the 
BIOS. 


This error can also be caused by a 
beotstrap file that contains a symbol table and 
relocation bits. To find out if the bootstrap 
program will fit on the system tracks without 
the symbol table and relocation bits, use the 
SIZE68 Utility to display the amount of Space 
the bootstrap program occupies. The first and 
second items returned by the SIZE68 Utility are 
the amount of space occupied by the text and 
data, respectively. The third item returned is 
the amount of space occupied by the BSS. The 
sum of the first two items, or the total minus 
the third item, will give you the amount of 
Space required for the bootstrap program on.the 
System tracks. Compare the amount of space 
your bootstrap program requires to the amount 
of space allocated by the OFF parameter. 


Because the symbol table and relocation 
bits are at the end of the file, the bootstrap 
program may have been entirely written to the 
System tracks and you can ignore this message. 
Or, you can run RELOC on the bootstrap file to 
remove the symbol table and relocation bits 
from the bootstrap file and reenter the PUTBOOT 
command line. ; 
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Table G=-l. (continued) 


Message Meaning 


User # range is (0-15) ’ 


Cccp. The user number specified in the command 
line is not supported by the BIOS. The valid 
range is enclosed in the square brackets in the 
error message. Specify a user number between 0 
and 15 (decimal) when you reenter the command 
line. 


Weite Error 


PUTBOOT. Either the disk to which PUTBOOT is 
writing is damaged or there is a hardware 
error. Insert-.a new disk and reenter the 
PUTBOOT command line. I£ the error persists, 
check for a hardware error. 


End of Appendix G 
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Call 50, 13 
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BIOS 

_ compiled, 7 

creating, 39 
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47 

BIOS function 0, L5 

BIOS function 0 
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BIOS function 2 Console 
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